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Read This First 



This Manual and Who It Is For 



This manual is for programmers who code in the assembler language. It 
is intended to help you assemble, link edit, and execute your program; 
to choose and specify the assembler options you need; and to interpret 
the listing and the diagnostic messages issued by the assembler. 
This manual also serves as a guide to information contained in other 
publications which is of importance to you as an assembler-language 
programmer. To use this manual you should have a basic understanding of 
the operating system as described in Introduction to OS , Order No. 
GC28-6534. You should also have a good understanding of the assembler 
language as described in OS/VS and DOS/VS Assembler Language , Order No. 
GC33-4010. 



Other Manuals You Will Need 

In addition to OS/VS and DOS/VS Assembler Language , you should have the 
following publications available when using this manual: 

System/370 Principles of Operation , Order No. GA22-7000 

OS/VS JCL Reference , Order No. GC28-0618 

OS/VS Linkage Editor and Loader , Order No. GC26-3803 

How This Manual Is Organized 

This manual has five main sections and seven appendixes : 

Introduction describes the purpose of the VS assembler, its relationship 
to the operating system, and its input and output. It also describes 
how the operating system processes your program and reviews the concepts 
of job, job step, job control language, and cataloged procedures. 

Job Control Statements for Assembler Jobs shows you how to invoke the 
assembler for simple jobs (using cataloged procedures) ; describes the 
assembler options and how to specify them; lists the job control 
statements that make up the four assembler cataloged procedures; and 
gives examples of how to use the cataloged procedures for more complex 
jobs. 

The Assembler Listing tells you how to interpret the printed listing 
produced by the assembler. 



Programming Considerations serves as a guide to information contained in 
other programming manuals which you will find useful as an 
assembler- language programmer. Among the topics discussed are: 

• Designing your program 

• Specifying the entry point 

• Linking with modules written in other languages 

• Linking with processing programs 

Adding Macro Definitions to a Library tells you how to catalog macro 
definitions in the system macro library or in a private library. 

Appendix A gives definitions of terms used in this manual. 

Appendix B gives the listing of the assembler sample program. 

Appendix C shows the detailed format of the object deck. 

Appendix D tells you how to invoke the assembler dynamically from a 

problem program. 

Appendix E describes the data sets used by the assembler and the 

assembler's storage requirements. 

Appendix F describes the SYSTERM listing. 

Appendix G explains the diagnostic messages issued by the assembler. 
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Introduction 



This section describes the purpose of the VS Assembler, its relationship 
to the operating system, and its input and output. It also tells you 
how the operating system processes your assembler language program and 
reviews the concepts of job, job step, job control language, and 
cataloged procedure. 



Purpose of the Assembler 

The purpose of the VS Assembler is to translate programs written in the 
assembler language into object modules, that is, code suitable as input 
to the linkage editor or loader. 



Relationship of the Assembler to the Operating System 

The VS Assembler is supplied with the OS/VS control program package. In 
the same way as the linkage editor or loader, it is executed under 
control of the OS control program. For a complete description of the 
relationship between a processing program and the various components of 
the control program, refer to Introduction to OS . 



Input 

As input the assembler accepts a program written in the Assembler 
language as defined i n Assembler Language . This program is referred to 
as a source module. Some statements in the source module (macro or COPY 
instructions) may cause additional input to be obtained from a macro 
library. 



Output 

The output from the assembler consists of an object module and program 
listing. The object module can either be punched, or included in a data 
set residing on a direct-access device or a magnetic tape. From that 
data set the object module can be read into the computer and processed 
by the linkage editor or loader. The format of the object module is 
described in Appendix C. 

The program listing lists all the statements in the module, both in 
source and machine language format, and gives other important 
information about the assembly (such as error messages) . The v listing is 
described in detail in the section "The Assembler Listing". 
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Compatibility 

The language supported fcy the VS Assembler is compatible with the 

language supported by the OS Assembler F. All prcgrairs which assemble 

error-free under Assembler F will also assemble error-free under the VS f "^ 

Assembler. However, the resulting object code may in cdd cases be v / 

different because of the extended features of the language supported by 

the VS Assembler (the extended attribute reference and SETC facilities) . 

How the Operating System Handles Your Program 

Cnce you have coded and punched your program, it must be processed by 

the assembler and the linkage editor or loader before it can be 

executed. (See Figure 1.) • 



ASSEMBLER 

The assembler translates your source module into an object module, the 
machine language equivalent of the source module. The object module, 
however, is not ready for execution; it must first be processed by the 
linkage editor or leader. 



LINKAGE EDITOR 

The linkage editor prepares your program for execution. The output of 

the linkage editor is called a load module and can be executed by the f 

computer. The linkage editor can combine your program with other object V 

modules and load modules to produce a single load module. The linkage 

editor stores your program in a load module library, a collection of 

data sets on a direct-access device. These load modules can be read 

into the computer and and given control. The load module library may be 

either permanent, so that you can execute your prcgrair in later jobs, or 

temporary, so that the program is deleted at the end cf your job. 



EXECUTION OF YOUR PROGRAM 

Cnce you have included your program in a permanent load mcdule library, 
you can execute it any number of times without assembly and linkage 
editing. However, if you need to change ycur program, ycu must assemble 
and linkage edit it again. Therefore, you should not store your program 
in a permanent load module library until it has been tested properly. 
To save time during test runs, you can use a program that combines the 
basic functions of the linkage editor with the execution cf ycur 
program. That program is the loader. 



LOADER 

The loader performs most of the functions cf the linkage editor; in 

addition, it loads your program into the computer and passes ccntrol to 

your program. The leader cannot, however, include your program in a f " 

v ; 



load irodule library. For a full description of the linkage editor and 
loader, refer to Linkage Editor and Loader . 



The source program is read in 
for processing by the assembler. 



The output of the assembler, 
[the object module, is placed 
I on auxiliary storage. 



|The object module is read 
| into either the linkage 
|editor or the loader for pro- 
cessing. 



\ After processing your program, 
I the loader gives control to it. 



[The linkage editor output, the 
■ load module, is placed on a 
load module library. 



fYour program, in load module 
| format, is read into the com- 
Iputer for execution. 



COMPUTER 



ASSEMBLER 



SOURCE 
MODULE 



LOADER 




LINKAGE 
EDITOR 



YOUR 
PROGRAM 




Figure 1. How the operating system handles your program. 
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Job Control Language and Cataloged Procedures 



JOBS AND JOE STEPS 



Each time you request a service from the operating system, you are 
asking it to perform a jot. A job may consist of several steps , each of 
which usually involves the execution of one processing program under the 
control of the VS control program. For example, if ycu submit a job to 
the computer calling for assembly and linkage editing of a program, that 
job will be a two-step job. The concepts of jobs and jcb steps are 
illustrated in Figure 2. 
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Figure 2. Jobs and job steps 
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JOB CONTROL LANGUAGE 



The job control language is your way of communicating tc the operating 
systeir: control program what services you want performed and what 
auxiliary devices you want used. Job control language (JCL) statements 
are usually punched into cards and supplied in the job stream together 
with your source module and other data needed by the job. 

For a detailed discussion of job control language statements, see 
JCL Reference . 

To save time and trouble, you can use predefined sets of JCL 
statements that reside in a library. Such a set cf statements, called a 
cataloged procedure, can be included in your job by means of a single 
JCL statement naming the set. Figure 3 illustrates the concept of a 
cataloged procedure. 

There are several cataloged procedures available for assembler jobs. 
They are described in the section "Job Control Statements for Assembler 
Jobs". 



Procedure 
Library 



Input 
Stream 




Figure 3 . The cataloged procedure concept 
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Job Control Statements for Assembler Jobs 



The purpose of this section is to: 

• Show you how to invoke the assembler for simple jcbs (using 
cataloged procedures) . 

Describe the assembler options and how to request them. 

• List the job control statements that make up the fcur assembler 
cataloged procedures. 

• Give examples of how to use the cataloged procedures for mere 
complex jcbs. 



Simple Assembly and Execution 

This section gives ycu the minimum JCL statements needed for two simple 
assembler jobs: 

• Assembly cf ycur program to produce a listing and an object deck. 

• Assembly and execution of your program. 

Eoth jobs use cataloged procedures to call the assembler. 

ASSEMBLY 

To assemble your program, use the following job control language (JCL) 
statements: 



Identifies the beginning of your job to the operating system. 

'jobname' is the name you assign to the job. 

'accountno' specifies the account to which your job is charged, 
//jobname JOB accountno, progrname,MSGLEVEL=l and 'progrname' the name of the programmer responsible for 
// EXEC ASMFCy the j°b- 'MSGLEVEL=1' specifies that the job control 

//SYS IN DD *^ %g statements connected with this job are to be listed. 

Check what parameters are required at your installation and 

how they must be specified. 



(your source program) 



|1 Calls the cataloged procedure ASMFC. As the result a number of job control statements j 
are included in the job from the procedure library. ASMFC is described under "The j 
Assembler Cataloged Procedures". 



Specifies that the assembler language source program follows immediately after this statement. 



Job Control Statements for Assembler Jots 
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These statements cause the assembler tc assemble ycur prcgram. and to 
produce a listing (described in the section "The Assembler Listing") and 
an object module punched on cards (described in Appendix C) . 

If you do not want any object module cards to be punched during the 
job, use the following statements: 



r 



//jobname JOB 
// EXEC 
//SYSIN DD 



accountno , progrname ,MSGLEVEL=1 
ASMFC , PARM=NODECK „ 



(your source program) 



I The second parameter (PARM) specifies the assembler option NODECK, 
telling the assembler not to produce any punched object module. For 
I a full discussion of the assembler options, see "Assembler Options". 



ASSEWELY ANE EXECUTION 



To run a job that both assembles and executes your program, cede the 
following statements: 



//jobname JOB accountno, progrname, MSGLEVEL=1 

// EXEC ASMFCG ...„ 

//ASM. SYSIN DD * j 



(your source program) 



Calls the procedure ASMFCG, containing job control statements for | 
execution of the assembler (in procedure step ASM ) and the loader inl 
(in step GO). 1 



Specifies that the input for procedure step ASM (assembly) follows 
immediately after this statement. i 



r 



//GO. SYS IN DD *~«ss« 



Specifies that the input for step GO (execution of your program under! 
control of the loader) follows immediately after this statement. I 



(data, if any, for your program) 



The first step of the ASMFCG procedure executes the assembler. The 
assembler produces a listing, a punched object module on cards, and an 
object module on a direct access device. The secend step causes the 
loader tc be executed. The loader transforms the object module, which 
was written on a direct access device by the assembler, into a lead 
module. In addition, the loader causes the load module (that is, your 
program) to be executed. 



n 



If you do not want the assembler to punch an object deck in this 
example, supply the following statements instead: 



//jobname JOB accountno ,progrname,MSGLEVEL=l 
// EXEC ASMFCG,PARM.ASM=(OBJ,NODECK) 

//ASM. SYS IN DD * k 



(your source program) 



The PARM parameter specifies the assembler options OBJ (telling the f 
| assembler'to produce an object module on the partitioned data set usedj 
| as input by the loader) and NODECK for step ASM (assembly) of the f 
| procedure. J 



//GO. SYS IN 



(data for your program) 



Assembler Options 



WHAT ASSEMBLER OPTIONS ARE 



Assembler options are functions of the assembler that you, as an 
assembler language programmer, can select. For example, ycu can use 
assembler options to specify whether or not ycu want the assembler to 
produce an cbject deck; whether or not you want it to print certain 
items in the listing; and whether or net ycu want it tc check ycur 
program for reenterability. 

The assembler options can be divided into four categories: 

• Listing control options , which determine the information to be 
included in the program listing. 

• Output control options , which specify the device en which the 
assembler object module is to be written and the contents of the 
module. 

• SYSTERM optio ns, which determine the information to be included in 
the listing produced on the SYSTERN data set. This data set is 
primarily for use by the Time Sharing Option (TSO) of VS2. 

• Other assembler options , which specify miscellaneous functions and 
values for the assembler. 

Figure 4 lists all the assembler options. The underlined values are the 
standard cr default values. These values are used by the assembler for 
options that you do not specify. 

As you can see from the figure, the options fall into twe format types: 

• Simple pairs of keywords: a positive form (for example, EECK) that 
requests a function, and an alternative negative fcrm (for example, 
NCDECK) that rejects the function. 

• Keywords that permit you to assign a value to a function (for 
example, LINECOUNT (40) ) . 



Job Control Statements for Assembler Jobs 
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HOW TO SPECIFY ASSEMBLER OPTIONS 

You use the PARM field of the EXEC JCL statement calling the assembler 

to specify the assembler options. Code FARM= followed by a list of f ' >, 

options that you have selected. For example, V /' 

//STEPA EXEC PGM=IFOX00 r PARM= , NODECK / FLAG (5) ,NORLE f 

IFOX00 is the name of the assembler; three options are specified for the 
execution of it. Default values are used for the ether options. 

When you use cataloged procedures, you will notice that most of them 

contain an option specification in the EXEC statement fcr the assembly. * 

To override such a specification, include a FARM field with your options 

in the EXEC statement calling the procedure. If the cataloged procedure 

contains mere than one step, ycu must add the procedure step name as a 

qualifier to the PARM operand. For example, 

//STEF1 EXEC ASMFCG,PARM.ASM= , CBJ,NCDECK , 

The .ASM is necessary to indicate the assembly step. P.s you can see in 
the section "The assembler Cataloged Procedures", the stepname for 
assembly is always ASM. You must also remember that when you override 
the FARM field in a procedure, the entire PARM field is overridden. The 
PARM field specification in the cataloged procedure ASMFCG is PARM=OBJ, 
and the CEJ option must be repeated when ycu override the PARM field. 
Otherwise the assembler default value NCCEJ will be used. (For a more 
detailed description of overriding operands en EXEC statements in 
cataloged procedures, refer to JCL Reference . 

The PARM field is ceded according to the following rules: 

• Single quotes or parentheses must surround the entire PARM value if 

ycu specify twe cr more options. /^~\ 

( ) 

9 The options must be separated by commas. Ycu .may specify as many 
options as ycu wish, and in any order. However, the length of the 
option list must net exceed 100 characters, including separating 
commas . 

• The BUFSIZE, FLAG, LINECOUNT, or SYSPARM options must appear within 
single quotes. 

• If you need to continue the PARM field onto another card, the entire 
PARM field must be enclosed in parentheses. However, any part of 
the FARM field enclosed in quotes must net be ccntinued on another 
card. 
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The following examples illustrate these rules: 



,PARM=DECK 



, PARM= ' LINECOUNT (401 ' 



Only one option specified, 



LINECOUNT, BUFSIZE, FLAG, 
and SYSPARM must be sur- 
rounded by quotes. 



, PARM= ( DECK , NOOB JECT \ 

or 
, PARM= ' DECK , NOOB JECT ' 



More than one option 
specified. None of them 
requires quotes. 



, PARM= ' DECK , NOLIST , SYSPARM (PARAM). ' 

or 
,PARM= (DECK, NOLIST, ' SYSPARM (PARAM 1 * 1 

or 
,PARM=(DECK, 'NOLIST, SYSPARM (PARAM) ' ) 



More than one option 
specified. SYSPARM must 
appear within quotes . 



,PARM=( DECK, NOLI ST, ' LINECOUNT ( 35 ) ' ,NOALIGN, 
MCALL, 'BUFSIZE (MIN} * ,NORLD) 



The whole field must be 
enclosed by parentheses, 
because it is continued 
onto another card. The 
LINECOUNT and BUFSIZE 
options must be within 
quotes, and the portions 
of the field that are en- 
closed within quotes 
cannot be continued onto 
another card. 



Job Control Statements fcr Assembler Jcbs 
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Listing Control Options 


ALOGIC 


Conditional assembly statements processed in 
open code are listed. 


NOALOGIC 


The ALOGIC option is suppressed. 


ESP 


The external symbol dictionary (ESD) is listed. (Refer 
to "The Assembler Listing" for further information on 
the ESD.) 


NOESD 


No ESD listing is printed. 


FLAG 


(nnn) 
(0) 


Diagnostic messages and MNOTE messages below 
severity code nnn will not appear in the listing. 
Diagnostic messages can have severity codes of 1, 
8, 12, 16, or 20 (20 is the most severe) , and 
MNOTE severity codes can be between and 255. 
For example , FLAG (8) suppresses diagnostic 
messages with a severity code of 4 and MNOTE 
messages with severity codes of through 7. 


LINECOUNT 


'(nn) 
(55) 


nn specifies the number of lines to be listed per 
page. 

An assembler listing is produced. 


LIST 




NOLI ST 


No assembler listing is produced. This option 
overrides ESD, RLD, and XREF. 


MCALL 


Inner macro instructions encountered during macro 
generation are listed following their respective 
outer macro instructions. The assembler assigns 
statement numbers to these instructions. The MCALL 
option is implied by the MLOGIC option; NOMCALL 
has no effect if MLOGIC is specified. 


NOMCALL 


The MCALL option is suppressed. 


MLOGIC 


All statements of a macro definition processed during 
macro generation are listed after the macro instruc- 
tion. The assembler assigns statement numbers to them. 


NOMLOGIC 


The MLOGIC option is suppressed. 



V / 



v. y 



Figure 4 . The assembler options 
(Part 1 of 5) 
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Listing Control Options (continued) 



NORLD 
LIBMAC 



NOLIBMAC 

XREF (FULL) 



XREF (SHORT) 



NOXREF 



The assembler produces the relocation dictionary as 
part of the listing. (Refer to "The Assembler Listing" 
for further information on the relocation dictionary.) 

The RLD is not printed. 

The macro definitions read from the macro libraries 
and any assembler statements following the logical 
END statement are listed after the logical END 
statement. The logical END statement is the first 
END statement processed during macro generation. 
It may appear in a macro or in open code; it may 
even be created by substitution. The assembler 
assigns statement numbers to the statements that 
follow the logical END statement. 

The LIBMAC option is suppressed. 

The assembler listing will contain a cross reference table 
of all symbols used in the assembly. This includes symbols 
that are defined but never referenced. The assembler 
listing will also contain a cross reference table of 
literals used in the assembly. 

The assembler listing will contain a cross reference 
table of all symbols that are referenced in the assembly. 
Any symbols defined but not referenced are not included 
in the table. The assembler listing will also contain 
a cross reference table of literals used in the assembly. 



No cross reference tables are printed. 



Figure 4. The assembler options 
(Part 2 of 5) 
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Output Control Options 


DECK 


The object module is written en the device specified 
in the SYSPUNCH EE statement, if this option is 
specified together with the OEJECT option, the object 
module will be written both en SYSPUKCH and en SYSGC. 


NOBECK 


The DECK option is suppressed. 


OBJECT 
or CEJ 


The object module is written on the device specified 
in the SYSGO EE statement. If this cpticn is 
specified together with the DECK option, the object 
module will be written both en SYSGO and en SYSPCKCH. 


NCOEJECT 


The OEJECT option is suppressed. 


or KCCEJ 


TEST 


The special source symbol table (SYW cards) is 
included in the object module. (See Appendix C 
for details.) 


NOTEST 


No SYN cards are produced. 






Figure 4. 



The assembler options 
(Part 3 of 5) 



v. y 
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SYSTERM Options 



NUMBER or 



NUM 



NONUMBER or 
NONUM 

STMT 



NOSTMT 

TERMINAL or 
TERM 



NOTEBMINAL or 



NCTEFM 



The line number field (columns 73-80 cf the input 
cards) is written in the SYSTERM listing for state- 
ments for which diagnostic information is given. This 
option is valid only if TERMINAL is specified. 

The NUMEER option is suppressed. 



The statement number assigned by the assembler is 
written in the SYSTERM listing fcr statements for which 
diagnostic information is given. This option is valid 
only if TERMINAL is specified. 

The STMT option is suppressed. 

The assembler writes diagnostic information on the 
SYSTERM data set. The diagnostic information, described 
in detail in Appendix F, consists of the diagnosed state- 
ment followed by the error message issued. 

The TERMINAL option is suppressed. 



Figure 4. The assembler options. 
(Part 4 cf 5) 
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Other Assembler Options 



ALIGN 



NOALIGN 



BUFSIZE(MIN) 



BUFSIZE (STD ) 



RENT 



NORENT 



((string) 
SYSFARMJ 

ML (null 

string) 



All data is aligned on the proper boundary in the object 
module; for example, an F-type constant is aligned on a 
fullword boundary. In addition, the assembler checks 
storage addresses used in machine instructions for 
alignment violations. 

The assembler does not align data areas other than 
those specified in CCW instructions. The assembler 
does not skip bytes to align constants on proper 
boundaries. Alignment violations in machine in- 
structions are not diagnosed. 

The assembler uses the minimum buffer size (790 bytes) 
for each of the utility data sets (SYSUT1, SYSUT2, 
and SYSUT3) . Storage normally used for buffers is 
allocated to work space. Because more work space 
is available, more complex programs can be assembled 
in a given region; but the speed of the assembly 
is substantially reduced. 

The buffer size that gives optimum performance is 
chosen. The buffer size depends on the size of 
the region or partition. Of the assembler working 
storage in excess of minimum requirements, 37% is 
allocated to the utility data set buffers, and the 
rest to macro generation dictionaries. 

Refer to Appendix E for a more complete description 
of the effects of BUFSIZE. 

The assembler checks your program for a possible 
violation of program reentrability. Code that makes your 
program non-reentrant is identified by an error 
message. 

The RENT option is suppressed. 



•string 1 is the value assigned to the system 
variable symbol SSYSPARM (explained in 
Assembler Language ) . Due to JCL restrictions, you 
cannot specify a SYSPARM value longer than 56 char- 
acters (as explained in Note 1 following this figure) 
Two quotes are needed to represent a single quote, 
and two ampersands to represent a single ampersand. 
For example, 

PARM= , OBJECT,SYSPARM((ggAM,« , BO) .FY) ' 

assigns the following value to SSYSPARM: 

(gaM^EOJ.FY . 

Any parentheses inside the string 
must be paired. If you call the assembler from a 
problem program (dynamic invocation) , SYSPARM 
can be up to 256 characters long. 



\ J 



( \ 

v. J 



Figure 4. The assembler options. 
(Part 5 of 5) 
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Note 1 ; The restrictions imposed upon the FARM field liirit the maximum 
length of the SYSFARM value to 56 characters. Consider the following 
example: 

// EXEC ASMFC , PARK. ASM= (0 EJECT ,N0EECK, 

// 'SYSFARM (AECE ) ') 



t t 



H H h 56 bytes « 

00 ^ 

8 R 



Since SYSFARM uses parentheses, it must he surrounded ty quotes. Thus, 
it cannot be continued onto a continuation card. The leftmost column 
that can be used is column 4 on a continue card. A qucte and the 
keyword must appear en that line as well as the closing quotes. In 
addition, either a right parenthesis, indicating the erd cf the FARM 
field, cr a comma, indicating that the FARM field is continued on the 
next card, must be coded before or in the last column cf the statement 
field (column 71) . 

Note 2 : Even though the formats of some of the options previously 
supported by OS Assembler F have been changed, you can use the old 
formats for the following options: ALGN (new ALIGN) , KCAIGN (KCAIIGK) , 
LINECKT=nn (LINECOUNT (nn) ) , LOAE (OBJECT) , and NOLOAD (NCCEJECT) . This 
support will, however, te continued only for a limited number cf VS 
releases, so you should change tc the new cptiens as seen as possible. 
The Assembler F option EOS is not supported by the VS Assembler. 



The Assembler Cataloged Procedures 

This secticn describes the four assembler cataloged procedures and tells 
you how to use them. They are: 

• ASMFC (assembly) 

• ASMFCL (assembly and linkage editing) 
o ASMFCG (assembly and loader-execution) 

• ASMFCLG (assembly, linkage editing, and execution) 

The procedure you chocse on each occasion will depend on the type cf 
job ycu want to run. First, you may want tc run an assembly tc ccrrect 
your coding and keypunching errors. For this, you would use the ASMFC 
procedure with the option NOEECK specified. In the next run ycu may 
want to assemble and execute your program, in which case you can use 
ASMFCG (or possibly ASMFCLG, if you use linkage editor features net 
supported by the loader) . When you have debugged ycur program, ycu may 
want to include it in a load module litrary using ASMFCL. 

The examples given in this section assume that the cataloged 
procedures ycu are using are identical to the cataloged procedures 
delivered by IEM. Therefore, you should first make sure that ycur 
installation has net medified the procedures after they were delivered. 
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AS SEN ELY (ASM EC) 



The ASMFC procedure contains only one jot step: asseirfcly. "Ycu 
use the name ASFMC to call this procedure. The result of execution 
is an object module, in punched card fcrir, and an assenbler listing. 

To call the procedure use the following statements: 



/ \ 



//jotname JOB parameters 
//stepname EXEC fASNFC | 

IPR0C=ASMFC J 
//SYS IN DD * 



scurce ircdule 



The statements of the ASttFC procedure shown in Figure 5 are read from 
the procedure library and merged into ycur input streair. Ihe S^SIK 
statement specifies that the input to the assembler (that is, your 
source program) follows immediately after the stateirert. 
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CD //ASMFC 


PROC 


m // ASM 


EXEC 


[3] //SYS LIB 


DD 


// 


DD 


SJ//SYSUT1 


DD 


// 




//SYSUT2 


DD 


//■ 




//SYSUT3 


DD 


[5] //SYSPRINT 


DD 


[g] //SYSPUNCH 


DD 



MAC= ■ SYS 1 . MACL IB ■ ,MAC 1 = ■ SYS 1 .MACLIB ' 

PGM=IFOX00 r REGION=12 8K 

DSN= SMAC , DISP=SHR 

DSN=SMAC1 , DISP=SHR 

DSN=SSSYSUT1,UNIT=SYSSQ,SPACE= (1700, (600,100)) , 
SEP= (SYSLIB) 

DSN=8 6SYSUT2,UNIT=SYSSQ,SPACE= (1700, (300,50)) , 
SEP= (SYSLIB, SYSUT1) 

DSN=g&SYSUT3,UNIT=SYSSQ,SPACE= (1700, (300,50) ) 

SYSOUT=A,DCB=BLKSIZE=1089 

SYSOUT=B 



HI This statement names the procedure and gives default values to 
the symbolic parameters MAC and MACl. 

\I\ This statement specifies that the program to be executed is 
IFOX00, which is the name of the assembler. 

The REGION parameter specifies the virtual storage region that 
gives best performance. It is possible to run the assembler in 
64K, in which case you must change the region size parameter. 
You can also add COND and PARM parameters. 

[3] This statement identifies the macro library data set. The 

succeeding statement concatenates another macro library with it. 
The default values for the DSN parameters of both data sets 
are SYS1.MACLIB, the system macro library. You can change either 
or both of the data sets in the EXEC statement calling the 
procedure. For example, to concatenate your own macro library 
with SYS1.MACLIB, code your EXEC statement as follows: 



// 



EXEC 



ASMFC , MAC 1=MYMAC S 



DISP=SHR indicates that the data set can be used simultaneously 
by other jobs in the system. 

SYSUT1, SYSUT2, and SYSUT3 specify the assembler work data sets. 
The device classname SYSSQ represents either a direct access 
device or a tape drive. The I/O units assigned to the class- 
names are specified by your installation during system genera- 
tion. Instead of a classname you can specify a unit name, such 
as 2314. The DSN parameters guarantee dedicated work data sets, 
if this is supported by your installation. The SEP and SPACE 
parameters are effective only if SYSSQ is a direct access 
device. The space required depends on the source program. 

This statement defines the standard system output class as the 
destination of the assembler listing. You can specify any 
blocksize that is a multiple of 121. 

This statement describes the data set that will receive the 
punched object module. 



Figure 5. Cataloged procedure for assembly (ASMFC) 
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ASSEMBLY AND LINK EDITING (ASMFCL) 

The ASMFCL procedure consists of two jot steps: asseirfcly and link 
editing. It produces an assembler listing, a linkage editor listing, 
and a load module. 

SYSGC contains the cutput from the assembly step and the input to the 
linkage editor step. It can be concatenated with additional input to 
the linkage editor. This additional input can be linkage editor control 
statements or other cbject modules. 

To call the procedure, use the following statements: 

//jobname JOB 

//stepname EXEC ASNFCL 

//ASK. SYS IN EC * 

source program statements 

/* 

//LKEE.SYSIN ED 



object module or 
linkage editor 
control statements 



/* 



necessary only if linkage 
editor is to combine modules 
or read linkage editor control 
information from the jcb stream 



Figure 6 shows the statements that make up the ASMFCL procedure. Only 
those statements net previously discussed are explained. 
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//ASMFCL 

//ASM 

//SYSLIB 

// 

//SYSUT 1 

// 

//SYSUT 2 

// 

//SYSUT 3 
//SYS PRINT 
//SYS PUNCH 
E //SYSGO 

// 

[2] //LKED 

// 

@I //SYSLIN 

s // 

g] //SYSLMOD 

//■ 

[6] //SYSUT 1 

// 

[7] //SYS PRINT 



PROC MAC= , SYS1.MACLIB' ,MAC1=' SYS1 .MACLIB ■ 

EXEC PGM=IFOX00,PARM=OBJ,REGION=128K 

ED DSN=gMAC,DISP=SHR 

ED DSN=gMAC1 ,DISP=SHR 

ED DSN=66SYSUT1 ,UNIT=SYSSQ,SPACE= (1700, (600, 100) ) , 

SEP= (SYSLIB) 
ED DSN=g6SYSUT2,UNIT=SYSSQ,SPACE=(1700, (300,50)) , 

SEP= (SYSLIB, SYSUT 1) 
ED DSN=g6SYSUT3,UNIT=SYSSQ,SPACE=(1700, (300,50)) 
DD SYSOUT=A,DCB=BLKSIZE=1089 
DD SYSOUT=B 
DD DSN=gSOBJSET,UNIT=SYSSQ,SPACE= (80, (200,50)) , 

DISP= (MOD, PASS) 
EXEC PGM=IEWL,PARM= (XREF, LET, LIST, NCAL) ,REGION=128K, 

COND=(8,LT,ASM) 
DD DSN= g gOBJSET , DISP= (OLD , DELETE) 
DD DDNAME=SYSIN 
DD DSN=ggGOSET (GO) ,UNIT=SYSDA,SPACE= (1024, (50,20,1) ) , 

DISP= (MOD, PASS) 
DD DSN=ggSYSUTl ,UNIT= (SYSDA,SEP= (SYSLIN, SYSLMOD) ) , 

SPACE=(1024, (50,20)) 
ED SYSOUT=A 



CD The SYSGO DD statement describes a temporary data set — the 
object module — which is to be passed to the linkage editor. 

HI This statement initiates linkage editor execution. The 
linkage editor options in the PARM= field cause the linkage 
editor to produce a cross-reference table, module map, and a 
list of all control statements processed by the linkage editor, 
The NCAL option suppresses the automatic library call function 
of the linkage editor. 

[3] This statement identifies the linkage editor input data set 
as the same one produced as output by the assembler. 

[4] This statement is used to concatenate any input to the linkage 
editor from the input stream with the input from the assembler, 

[U This statement specifies the linkage editor output data set 
(the load module) . As specified, the data set will be 
deleted at the end of the job. If it is desired to retain 
the load module, the DSN -parameter must be respecified and a 
DISP parameter added. If the output of the linkage editor is 
to be retained, the DSN parameter must specify a library name 
and member name designating where the load module is to be 
placed. The DISP parameter must specify either KEEP or 
C ATLG . 

[6] This statement specifies the utility data set for the linkage 
editor. 

This statement identifies the standard output class as the 
destination for the linkage editor listing. 



Figure 6. Cataloged procedure for asseirbly and link editing (ASMFCL) 
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ASSEMBLY, LINK EDITING AND EXECUTION (ASMFCLG) 



The ASMFCLG consists cf three job steps: assembly, link editing and 
execution. An assembler listing, an object deck, and a linkage editor 
listing are produced. 

The statements entered in the input stream tc use this procedure are: 



V 



//jobname JOB 

//stepname EXEC ASMFCLG 

//ASM.SYSIN DD * 



source program statements 



/* 

//LKED. SYSIN DD 



object module or 
linkage editor 
centre! statements 



/* 

//GC.ddname DD 

//GO . ddname DD 

//GC.ddname DD 



necessary only if linkage 
editor is tc combine modules 
or read linkage editor control 
information froir the job stream 



parameters 
parameters 
* 



problem program input 



only 

if 

necessary 



/* 



Figure 7 shows the statements that make up the ASMFCLG procedure. Only 
those statements net previously discussed are explained in the figure. 
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//ASMFCLG 

//ASM 

//SYSLIB 

// 

//SYSUT1 

// 

//SYSUT2 

// 

//SYSUT3 
//SYSPRINT 
//SYS PUNCH 
//SYSGO 

// 

Q] //LKED 

// 

//SYSLIN 

// 

El //SYSLMOD 

// 
//SYSUT 1 

// 

//SYSPRINT 
HI //GO 



PROC MAC=*SYS1 .MACLIB' ,MAC1=' SYS1 .MACLIB' 

EXEC PGM=IFOX00,PARM=OBJ,REGION=128K 

ED DSN= £MAC , DISP=SHR 

BD DSN=SMAC1 ,DISP=SHR 

BD DSN=SSSYSUT1 ,UNIT=SYSSQ,SPACE= (1700, (600, 100) ) , 

SEP= (SYSLIB) 
DD DSN=ggSYSUT2,UNIT=SYSSQ,SPACE= (1700, (300,50)) , 

SEP= (SYSLIB, SYSUT1) 
DD DSN=8SSYSUT3,UNIT=SYSSQ,SPACE= (1700, (300,50)) 
BD SYSOUT=A,DCB=BLKSIZE=1089 
DD SYSOUT=B 
DD DSN=SSOBJSET,UNIT=SYSSQ,SPACE= (80, (200,50)) , 

DISP= (MOD, PASS) 
EXEC PGM=IEWL,PARM= (XREF, LET, LIST, NCAL) ,REGION=128K, 

COND= (8,LT,ASM) 
DD DSN=ggOBJSET,DISP= (OLD, DELETE) 
DD DDNAME=SYSIN 
DD DSN=&SGOSET (GO) ,UNIT=SYSDA,SPACE= (1024, (50,20,1)) , 

DISP= (MOD, PASS) 
ED DSN=SSSYSUT1 ,UNIT= (SYSDA,SEP= (SYSLIN, SYSLMOD) ) , 

SPACE= (102U, (50,20)) 
DD SYSOUT=A 
EXEC PGM=*. LKED. SYSLMOD, COND= ((8, LT, ASM) , (4,LT,LKED)) 



E The LET linkage editor option specified in this statement 
causes the linkage editor to mark the load module as 
executable even though errors were encountered during pro- 
cessing. 

El The output of the linkage editor is specified as a member 
of a temporary data set, residing on a direct-access device, 
and is to be passed to a succeeding job step. 

El This statement initiates execution of the assembled and 

linkage edited program. The notation +. LKED. SYSLMOD identifies 
the program to be executed as being in the data set described 
in job step LKED by the DD statement named SYSLMOD. 



Figure 7. Cataloged procedure for assembly, link editing, and execution 
(ASMFCLG) 



Job Control Statements for Assembler Jobs 
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aSSEKELY flNE LQAEER-EXECUTION (ASMECG) 

The ASMFCG procedure contains two job steps: assembly and 
loader-execution. The loader link-edits, loads, and passes ccntrcl to 
the program fcr execution . 

Both assembler and a loader listing are produced, but the lead module is 
not included in a library. 

To call the procedure use the following statements: 

//jobname JOB 

//stepname EXEC ASMFCG 

//ASM.SYSIN ED * 



scurce program 



/* 

//GC.ddname DD 

//GO.ddname DD 

//GC.ddname DD 



parameters 
parameters 



problem program input 



enly 
t if 
necessary 



/* 

Figure 8 shows the statements that make up the ASKFCG procedure. Only 
those statements net previously discussed are explained in the figure. 



( \ 
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//ASMFCG 

//ASM 

//SYSLIB 

// 

//SYSUT 1 

// 

//SYSUT 2 

// 

//SYSUT3 
//SYS PRINT 
//SYS PUNCH 
//SYSGO 
// 

m//Go 
// 

[2] //SYSLIN 
H] //SYSLOUT 



PROC MAC='SYS1 .MACLIB 1 ,MAC1=" SYS1 .MACLIB' 

EXEC PGM=IFOX00,PARM=OBJ,REGION=128K 

BD BSN=gMAC,BISP=SHR 

BD BSN=SMAC1 ,BISP=SHR 

BB BSN=ggSYSUTl,UNIT=SYSSQ,SPACE=(1700, (600,100)) , 

SEP= (SYSLIB) 
BB BSN=ggSYSUT2,UNIT=SYSSQ,SPACE= (1700, (300,50)) , 

SEP= (SYSLIB, SYSUT1) 
BB BSN=gSSYSUT3,UNIT=SYSSQ,SPACE= (1700, (300,50)) 
BB SYSOUT=A,BCB=BLKSIZE=1089 
BB SYSOUT=B 
BB BSN=ggOBJSET,UNIT=SYSSQ,SPACE= (80, (200,50) ) , 

BISP= (MOB, PASS) 
EXEC PGM=LOABER,PARM=»MAP, PRINT, NOCALL, LET* , 

CONB= (8,LT,ASM) 
BB BSN=ggOBJSET,BISP=(OLB,BELETE) 
BB SYSOUT=A 



[Q This statement initiates the loader-execution. The loader 
options in the PARM= field cause the loader to produce a 
map and print the map and diagnostics. The NOCALL option 
is the same as NCAL for linkage editor and the LET option is 
the same as for linkage editor . 

(2] This statement defines the loader input data set as the same 
one produced as output by the assembler. 

GD This statement identifies the standard output class as the 
destination for the loader listing. 



Figure 8. Cataloged procedure for assembly and loader-execution 
(ASMFCG) 



Job Control Statements for Assembler Jobs 



31 



EXAMPLES 



The following examples demonstrate the use of the assembler cataloged 
procedures. Normally, you will want to change or add parameters to the 
procedures you use. The examples illustrate how ycu use the EXEC 
statement calling the procedure to change or add parameters to EXEC 
statements in the procedure; and how ycu add DD statements after the 
EXEC statement calling the procedure to change cr add ED statement 
parameters. The rules for overriding parts of cataloged procedures for 
the duration of a jofc are explained in JCL Reference . 



r \ 

K J 



Example 1 : 

In the procedure ASMFC, the punched object deck can be suppressed and 
the UNIT and SPACE parameters of data set SYSUT1 can be respecified by 
coding the following statements: 

//stepname EXEC aSMFC,P£RM=NODECK 

//SYSUT1 DD UNIT=2311,SFACE= (200, (300, U0)) 

//SYSIN ED * 

source statements 
/* 



Example 2 : 

In the procedure &SMFCLG, the assembler listing can be suppressed and 
the COND parameter, which sets conditions for execution of the linkage 
editor, can be changed by the following statements: 

//stepname EXEC ASNFCLG,PARtf .ASN= (NCLIST,OEJECT) , 
// C0NE.LKED= (8,LT,PREVSTEP.ASM) 

//ASK. SYS IN ED * 



/* 



source statements 



Here PREVSTEP is the name of a previous EXEC statement calling an 
assembler procedure in the same job. 

Note : You cannot override individual options in the PARK field. The 
whole PARK field is always overridden. Therefore, ycu must repeat 
OBJECT in the example above. 



Example 3 : 

The following example shows the use of the procedure ASMFCL to: 

• Read input from a unlabeled nine-track tape en tape drive 282. The 
tape has a blocking factor of ten. 

• Put the output listing on a tape labeled VOLIE=T£FE10, with a data 
set name of PF.OG1 and a blocking factor cf five (605 divided by 121, 
the record size for the assembler listing) . 

• Block the SYSGO output cf the assembler and use it as input to the 
linkage editor with a blocking factor cf five. 

• Link-edit the module only if there are nc errcrs in the assembly 

(COND=0) . 
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//ASM.SYSPRINT 


DD 


// 




//ASM.SYSGO 


DD 


//ASM.SYSIN 


DD 


// 




//LKED.SYSLMOD 


DD 



o Link- edit the module onto a previously allocated and cataloged data 
set, USER. LIBRARY with a member name of PROG. 

// EXEC ASMFCL,COND.LKED= (0,NE,ASM) 

DSN=PR0GR1 , UNIT=TAPE, DISP= (NEW, KEEP) , 
VOL=SER=TAPE 1 , DCB=BLKSI ZE=6 05 
DCB=BLKSIZE=400 

UNIT=282,LABEL= (,NL) ,DISP=OLD, 
DCB= (RECFM=FSB,BLKSIZE=800) 
DSN=USER. LIBRARY (PROG) ,DISP=OLD 

Note : The order in which the overriding DD statements are specified 
corresponds to the order of DD statements in the procedure. For 
example, SYSPRINT precedes SYSGO in step ASM. The DD name ASM.SYSIN is 
placed last among the overriding statements for step ASM, because SYSIN 
does not exist in step ASM of the procedure. 

Example 4 : 

The following example shows assembly of two programs, link editing of 
the two object modules into one load module, and execution of the load 
module: 



//STEP1 
//ASM.SYSGO 

//ASM.SYSIN 



EXEC ASMFC,PARM.ASM=OBJ 

DD DSN=SgOBJSET,UNIT=SYSSQ,SPACE= (80, (200,50) ) , 

DISP= (MOD, PASS) ,DCB=BLKSIZE=U00 
DD * 

source module 1 



/* 

//STEP2 EXEC 

//ASM.SYSGO DD 

//ASM.SYSIN DD 



ASMFCLG 

DCB=BLKSIZE=400,DISP= (MOD, PASS) 

* 



source module 2 



/* 

//LKED.SYSLIN DD 
//LKED. SYSIN DD 

ENTRY 

/* 

//GO.ddname DD 

// 



DCB=BLKSIZE=400 
* 

PROG 



(dd cards for GO step) 



The LKED. SYSIN statement indicates that input to the linkage editor 
follows. In this case it is a linkage editor control statement. ENTRY, 
which identifies PROG, an external symbol in one of the two modules, as 
the entry point into the load module. When the load module is executed, 
that point in the module gets control first. 

JCL Reference provides additional information on overriding techniques. 
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The Assembler Listing 



/-"> 



This section tells you how to interpret the printed listing produced by 
the assembler. The listing is obtained only if the option LIST is in 
effect. Parts of the listing can be suppressed by using other options; 
for information on the listing options, refer to "Assembler Options". 

The six parts of the assembler listing are: 

• External symbol dictionary (ESE) 

• Source and object program 

• Relocation dictionary (RLE) 

• Symbol cross reference 

• Literal cross reference 

• Eiagnostics and statistics 

Figure 9 shows the different parts of the listing. The function and 
purpose of each of them, as well as the individual details, are 
explained in the following text and illustrations. 



J 
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EXAM 



SYMBOL TYPE ID ADDR LENGTH LDID 



EXTERNAL SYMBOL DICTIONARY 



PAGE 



ASM 0100 09. 46 01/05/72 



SEARCH 



PC 0001 000000 0001CO 

LD 000024 0001 



SAMPLE PROGRAM 



STMT SOURCE STATEMENT 



ADDR1 ADDR2 



LOC OBJECT CODE 

000000 

000000 05C0 

000002 9857 C1A6 

000006 45E0 C022 
0000OA 9180 C020 
00000E 4710 C018 

*** ERROR *** 

*** ERROR *** 



000012 5820 500C 0000C 

000016 5020 1004 00004 

00001A 9680 5008 00008 

00001E 8756 C004 00006 



PAGE 



ASM 0100 09.46 01/05/72 



52 ********* ******************************************************** ****** SAMPL050 

53 * MAIN ROUTINE *SAMPL051 

54 *********************************************************************** SAMPL052 



55 
56 

57 BEGIN 
58 
00002 59 
001A8 60 

00000 61 MORE 

00024 62 

00022 63 

0001A 64 

00000 65 



CSEC'i 

ENTRY SEARCH 
BALR R12,0 
USING *,R12 



SAMPL053 

SAMPL054 

ESTABLISH ADDRESSABILITY OF PROGRAM SAMPL055 

AND TELL THE ASSEMBLER SAMPL056 



LM R5,R7,=A (LISTAREA, 16,LISTEND) LOAD LIST AREA P ARAMS SAMPL0 57 

USING LIST,R5 REGISTER 5 POINTS TO THE LIST SAMPL058 

BAL R1 4, SEARCH FIND LIST ENTRY IN TABLE SAMPL059 

TM SWITCH, NONE CHECK TO SEE IF N£ME WAS FOUND SAMPL060 

BO NOTTHERE BRANCH IF NOT SAMPL06 1 

USING TABLE, R1 REGISTER 1 NOW POINTS TO TABLE ENTRY SAMPL062 

MOVE TSWITCH,LSWITCH MOVE FUNCTIONS SAMPL063 



66+ 1, IMPROPER OPERAND TYPES, NO STATEMENTS GENERATED 

67 MOUE TNUMBER,LNUMBER FROM LIST ENTRY 

68 MOVE TADDRESS,LADDRESS TO TABLE ENTRY 
69+* NEXT TWO STATEMENTS GENERATED FOR MOVE MACRO 
70+ L 2,LADDR£SS 
71+ ST 2,TADDRESS 



72 lMOTTHERE OI 

73 BXLE 

74 EOJ 



LSWITCH,NONE 
R5,R6,MORE 



TURN ON SWITCH IN LIST ENTRY 

LOOP THROUGH THE LIST 

END OF PROGRAM, USER LIBRARY MACRO 



SAMPL066 

SAMPL069 
SAMFL028 
SAMPL029 
SAMFL030 
SAMPL075 
SAMPL076 
SAMPL077 



RELOCATION DICTIONARY 



POS.ID 


REL.ID 


FLAGS 


ADDRESS 


0001 


0001 


0C 


000154 


0001 


0001 


0C 


000164 


0001 


0001 


OC 


000174 


0001 


0001 


OC 


0001A8 


0001 


0001 


OC 


0001B0 



PAGE 6 
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EXAM 



SYMBOL 

BEGIN 

HIGHER 

LADDRESS 

LIST 

LISTAREA 

LISTEND 

LNAME 

LNUMBER 

LOOP 



CROSS-REFERENCE 



LEN VALUE DEFN 

00002 00000000 00057 

00002 0000004A 00090 
00004 0000000C 00174 
00001 00000000 00170 
00008 00000148 00132 
00008 00000198 00152 
00008 00000000 00171 

00003 00000009 00173 

00004 00000030 00083 



REFERENCES 

00135 00143 00183 

00085 

00070 

00060 

00184 

00184 

00084 

00088 00091 00139 



PAGE 7 
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EXAM 



SYMBOL 



LITERAL CROSS-REFERENCE 



LEN VALUE DEFN 



REFERENCES 



PAGE 8 
ASM 0100 09.46 01/05/72 



=A (LISTAREA, 16, LISTEND) 

00004 000001A8 00184 00059 
=F , 128,4,128« 

00004 000001B4 00185 00081 



EXAM 



STMT ERROR CODE MESSAGE 



ASSEMBLER DIAGNOSTICS AND STATISTICS 



PAGE 



ASM 0100 09.46 01/05/72 



IFO076 SEQUENCE SYMBOL .TYPECGK IS UNDEFINED IN MACRO MOVE 

36 IFO016 ILLEGAL OR INVALID NAME FIELD 

65 IFO090 UNDEFINED SEQUENCE SYMBOL ENCOUNTERED DURING CONDITIONAL ASSEMBLY 

66 IF0197 *** MNOTE *** 



Figure 9. Assembler listing 
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External Symbol Dictionary (ESD) 

The external symbol dictionary (ESD) describes the contents of the ESE 
records included in the object module produced by the assembler. It .— 

describes to the linkage editor or loader the control sections and ( \ 

external symbols defined in the module. 

This section helps you find references between modules in a 
multi-module program. The ESE may be particularly helpful in debugging 
the execution of large programs constructed from several modules. 

The ESD is explained in detail in Figure 10. For a full 
understanding of the terms and concepts used in the figure, refer to 
"Section E: Program Sectioning" and "Section F: Addressing" in 
Assembler Lan guage. 
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The deck identification 
obtained from the name 
field of the first named 
TITLE statement. 



i The type designator for the entry. The various type designators are: 

CM Common control section. A control section defined by a 

] COM instruction 

l ER Strong external reference. A symbol that appears in the 

operand field of an EXTRN instruction, or is defined as 

a V-type address constant. 
LD External name (label definition). A symbol that appears in 

the operand field of an ENTRY instruction. 
PC Unnamed control section (private code). An unnamed 

control section is generated as the result of an unnamed 

START or CSECT instruction or the appearance of an 

instruction affecting the location counter before the first 

START or CSECT instruction. 
SD Named control section. A control section identified by 

a START or CSECT instruction with a label in the name 

field. 
WX Weak external reference . A symbol that appears in the name 

field of a WXTRN instruction. 
XD External dummy section (pseudo register). A symbol that 

appears in the name field of a DXD instruction, or appears 

both in the name field of a DSECT instruction and the 

operand field of a Q-type address constant. 



j The version 
] of the 
j assembler 



The time and 
date when the 
run is made 



j The name of the symbol 
I described by the entry. I 
I (Only for types CM, ER, 
j LD, SD, WX, and XD). 



EXAM 

sykbolJ 

/ 

f 

SEARCH 


type /id addr length ldid 

PC 0001 000000 0001CO 

LD I 000024 -^ 0001 


EXTERNAL SYMBOL DICTIONARY 


1 1 

1 PAGE 1 1 
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The external symbol dictionary identification 
number (ESDID). This number is a unique 
four- digit hexadecimal number identifying 
the entry. It is used to cross reference be- 
tween the external symbol dictionary and the 
relocation dictionary. It is also used by entries 
of type LD to identify the control section in 
which the external name is defined. (Only for 
types CM, ER, PC, SD, WX, and XD). 



The address in the 



j module where the 
j item described by 
j the entry is defined. 
J (Only for types CM, 
I LD, PC, SD, and XD). 



The length in bytes 
(hexadecimal notation), 
of the assembled con- 
trol section. (Only for 
types CM, PC, SD, and 
XD). 



I The ESDID assigned to 
j the control section in 
I which this symbol is 
I defined. (Only for 
I type LD). 



Figure 10. External symbol dictionary 
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The Source and Machine Language Statements 

The second section of the listing contains a copy of the source 

statements of the module together with a copy of the object code / n 

produced by the assembler for each of the source statements. ' K 

This section is the most useful part of the listing because it gives you 
a copy of all the statements in your source program (except listing 
control statements) exactly as they are entered into the machine. You 
can use it to find simple punching errors, and together with the 
diagnostics and statistics, to locate and correct errors detected by the 
assembler. By using this section together with the cross reference 
section, you can check that your branches and data references are in 
order. The location counter values and the object cede listed for each 
statement help ycu locate any errors in a storage dump. Finally, you 
can use this part of the listing to check that your macrc instructions 
have been expanded properly. 

The source and machine language statements section is described in 
detail in Figure 11. For terms that you are unfamiliar with, refer to 
Assembler Language . 



SOURCE STATEMENT FIELDS 



The contents of the source statement fields in the listing (see Figure 
11) are as fellows: 

• All source statements except listing control statements are listed, 
including statements generated from macrcs and inserted by CCFY 
instructions. 

• The definitions of library macros that are called by the program are 
listed enly if the LIBMAC option has been specified. 

• The statements generated as the result of a macro instruction are 
listed after the macro instruction in the listing unless FRINT NCGEK 
is in effect. 

• Unless the NOALOGIC option has been specified, assembler and machine 
instructions with variable symbols in open code are listed both as 
they appear in the input to the assembler and with values 
substituted for the variable symbols. 

• When the assembler detects an error, it normally inserts an error 
indicator in the listing after the statement in error, and prints an 
error message in the diagnostics and statistics secticn. Using the 
FLAG option you can suppress error messages below a severity code 
that you choose. 

• MNOTE messages appear inline where they are generated. KNCTE 
messages can be suppressed in the same way as errcr messages using 
the FLAG cpticn. 

• Literals that have not been assigned locations by LTORG instructions 
appear after the ENE instruction. 

• A generated statement has the same format as the statement from 
which it was generated, unless a substituted value is longer than 
the variable symbol used in the model statement. 

• Any statement in which the assembler finds an errcr is listed, even 
if it would not otherwise be listed. (Fcr example, an AIF statement 
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in a called library macro definition) . 

For a statement generated from a macro definition, columns 73-80 
contain the columns from the model statement frcm which it was 
generated. 
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The title defined in 
the operand field of 
the TITLE statement 



The location counter value (address in hexadecimal notation) of the 
assembled code. Exceptions are the following values: 

• For END with an operand: the address. of the symbol in the operand. 
■ For ORG: the location counter value before the ORG operation. 

• For COM, CSECT, or DSECT: the current address of the control 
section. 

• For ENTRY, EXTRN, WXTRN, or DXD: blank. 

• For LTORG: the address assigned to the literal pool. 



Columns 1 - 80 of the 
source statements 
records, as explained 
under "Source Statement 
Fields". 



c 



EXAM 


SAMPLE PROGRAM ^ 












PAGE 3 


LOC 


OBJECT CODE, 


*;' AEDR1 


ADDR2 


STMT 
52 


SOURCE STATE 


W ENT J" ASM 0100 09.1*6 


01/05/72 


************** 


********************************************************* 


SAMPL050 




s<>s0 






53 


* MAIN 


ROUTINE 


* 


SAMPL051 




JS^ 






5« 


************** 


********************************************************* 


SAMPL052 


000000 








55 
56 


CSEC'i 
ENTRY 


SEARCH 




SAMPL053 
SAMPL05« 


000000 


05C0 






57 


BEGIN BALR 


R12,0 ESTABLISH ADDRESSABILITY 


OF PROGRAM 


SAMPL055 








00002 


58 


USING 


*,R12 AND TELL THE ASSEMBLER 




SAKPL056 


000002 


9857 C1A6 


001A8 




59 


LM 


R5,R7,=A(LISTAREA,16,LISTEND) LOAD LIST 


AREA PARAMS 


SAMPL057 








00000 


60 


USING 


LIST.R5 REGISTER 5 POINTS TO THE 


LIST 


SAMPL058 


000006 


U5E0 C022 


0002U 




61 


MORE BAL 


R1 <*, SEARCH FIND LIST ENTRY IN TABLE 




SAMPL059 


00000A 


9180 C020 


00022 




62 


TM 


SWITCH, NONE CHECK TO SEE IF NAME WAS 


FOUND 


SAMPL060 


OOOOOE 


4710 C018 


000 1A 




63 


BO 


NOTTHERE BRANCH IF NOT 




SAMPL061 








00000 


64 
65 


USING 
MOVE 


TABLE, R1 REGISTER 1 NOW POINTS TO 
TSWITCH.LSW1TCH MOVE FUNCTIONS 


TABLE ENTRY 


SAMPL062 
SAMPL063 




*♦* ERROR 


*♦* 




664 
67 


1, IMPROPER 
KOUE 


OPERAND TYPES, NO STATEMENTS GENERATED 
TNUMBER,LNUMBER FROM LIST ENTRY 




SAMPL066 




*♦* ERROR 


♦ ** 




68 
69* 


MOVE 
* NEXT 


TADDRESS,LADDRESS TO TABLE ENTRY 
fWO STATEMENTS GENERATED FOR MOVE MACRO 




SAMPL069 
SAMFL028 


000012 


5820 500C 


ooooc 




70+ 


L 


2,LADDRESS 




SAMPL029 


000016 


5020 ^1004 


oooou 




71+ ST 


2.TADDRESS 




SAKFL030 


- — -~ ' •' 









The source statement number. I 
Used to cross reference between If 
this section and the cross I 

reference and diagnostics sections. || 






The machine language code produced from the source 
statement on the same line. The entries are left-justified. 
Machine instructions are printed in full , with a blank 
inserted after every four digits. Assembler instructions 
are printed in full only if the PRINT instruction option 
DATA is in effect. For instructions that do not generate 
any object code this field is blank. 



The effective address (result of adding together a base 
register value and a displacement value) for: 

First column: the first operand of an SI or SS type 

instruction. 

Second Column: the second operand of an RS, RX, 

or SS type machine instruction. 

This column also contains: 

For ORG: the location counter value after the 
ORG operation. 

For USING: the first operand value. 
For EQU: the value of the symbol. 
Both fields contain six digits; however, if the high 
order digit is zero, it is not printed. 



Figure 11. Source and machine language statements 
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Relocation Dictionary (RLD) 



The relocation dictionary (RLE) describes the contents of the RLD records 
passed to the linkage editor or loader in the object module. The 
entries describe those address constants in the mcdule that are affected 
by program relocation. 



The section helps you find the relocatable constants in ycur program. 

The RLD section is described in detail in Figure 12. For a 
description of the different address constants mentioned in the figure, 
refer to the section "G3 — Defining Data", in Assembler Language . 



EXAM 










RELOCATION DICTIONARY 


PAGE 6 


POS.ID 


REL.ID 


FLAGS 


ADDRESS 
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0001 


0001 


OC 


000151 








0001 


0001 


OC 


000164 








0001 


0001 


OC 


000174 








0001 


0001 


OC 


0001A8 








0001 


0001 


OC 


0001 B0 
















"~" "":- 


llts*^ 


^"^ 



The address where the constant is stored 
(the location counter value assigned to 
the definition of the constant). 



This two-digit hexadecimal number is interpreted as follows: 

First digit: Identifies the type of entry: 

= A- or Y- type address constant 

1 = V- type address constant 
2«= Q- type address constant 
3 = CXD entry 

Second digit: The first three bits indicate the length of 
the constant and whether the base should be added or 
subtracted: 



Bits and 1 

00 = 1 byte 

01 = 2 bytes 
10-3 bytes 
11=4 bytes 



Bit 2 
0= + 
1 =- 



Bit 3 
Always 



The external symbol dictionary 
identification number (ESDID) 
assigned to the ESD entry for 
the control section in which the 
address constant is used as an 
operand. 



The ESDID assigned to the ESD 
entry for the control section in 
which the referenced symbol is 
defined, or to the ESD entry 
identifying it as an external 
reference. 



Figure 12 . Relocation dictionary 
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Symbol Cross Reference 

The symbol cress reference section of the listing lists the symbols used 
in the module , indicating both where they are defined and where they are 
referenced. This is a useful tool in checking the logic cf ycur program; 
it helps you see if your data references and branches are in crder. 

The symbol cross reference section contains all symbols in the 
module, except those appearing in the operand field cf V-type address 
constants. Thus, symbols that are not listed in the scurce and machine 
language statements section because of a PRINT OFF cr PRINT NOGEN 
instruction will appear in the cross reference table. (For a description 
of V-type address constants and the PRINT instruction , refer to 
Assembler Language . 

Symbols that are undefined but referenced will alsc be listed, and 
identified as undefined. Duplicate definitions will alsc be identified 
in the table. 

Figure 13 describes in detail the items cf the cress reference table. 

Note : The cross reference entry for a symbol used in a literal refers 
to the assembled literal in the literal peel. Lock up the literal cross 
reference table tc find where the symbol is used. 



s~\ 
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CROSS-REFERENCE 



LEN VALUE DEFN 



REFERENCES 



PAGE 7 
ASM 0100 09.46 01/05/72 



BEGIN 


00002 


00000000 00057 


00135 


00143 


00183 




HIGHER 


00002 


0000004A 00090 


00085 








LADDRESS 


00004 


0000000C 00174 


00070 








LIST 


00001 


00000000 00170 


00060 








LISTAREA 


00008 


00000148 00132 


00184 








LISTEND 


00008 


00000198 00152 


00184 








LNAME 


00008 


00000000 00171 


00084 








LNUMBER 


00003 


00000009 00173 










LOOP 


00004 


00000030 00083 


00088 


00091 


00139 




LSW1TCH 


00001 


00000008 00172 


00072 








MORE 


00004 


00000006 00061 


00073 








MORE 


00004 


00000042 00088 


•♦♦♦DUPLICATE**** 




NONE 


00001 


00000080 00076 


00062 


00072 


00080 00092 




NOTFOUND 


00004 


00000050 00092 


00089 








NOTTHERE 


00004 


0000001A 00072 


00063 








R1 


00001 


00000001 00159 


00064 


00081 


00082 00082 00087 


00090 


R12 


00001 


0000000C 00165 


00057 


00058 






R14 


00001 


0000000E 00166 


00061 


00086 


00093 




R2 


00001 


00000002 00160 


00088 


00091 






R3 


00001 


00000003 00161 


00081 


00083 


00087 00090 




R5 


00001 


00000005 00162 


00059 


00060 


00073 




R6 


00001 


00000006 00163 


00073 








R7 


00001 


00000007 00164 


00059 








SEARCH 


00004 


00000024 00080 


00056 


00061 






SWITCH 


00001 


00000022 00075 


00062 


00080 


00092 S\. 




TABLAREA 


00008 


00000058 00099 


00082 








TABLE 


00001 


00000000 00178 


00064 








TADDRESS 


00004 


00000004 00181 


00071 








TNAME 


00008 


00000008 00182 


00084 








TNUMBER 


00003 


00000000 00179 










TSWITCH 


00001 


00000003 00180 












The statement numbers of the 
statements in which the symbol 
appears in the operand field. 



The statement number of the 
statement in which the symbol 
is defined. 



Either the address represented 
by the symbol, or the value to 
which it is equated. 



The Symbol 



The length (hexadecimal notation), 
in bytes, of the field occupied by 
the value of the symbol. 



Figure 13. Symbol cross reference 
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Literal Cross Reference 



The literal cross reference section lists all the literals that are used 
in the program. 

Figure 14 gives a detailed explanation of the items of the literal 
cross reference table. 



( \ 

\ J 



LITERAL CROSS-REFERENCE 



SYMBOL 



LEN VALUE DEFN 



REFERENCES 



=A (LISTABEA,16,LISTEND) 

00004 000001A8 00184 00059 
=F'128,4,128' 

| 00004 000001B4 00185 00081 



PAGE 8 
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The statement numbers of the statements [ \ 
in which the literal is used in the source i 
code input. || 



The statement number assigned to the 
literal. Statement numbers for literals 
are assigned after LTORG instructions 
or after the END instruction. 



The address represented by the 
literal (the address at which the | 
literal is assembled) 



The length (hexadecimal notation), 
in bytes, of the field occupied by 
the literal. 



The literal 



Figure 14. Literal cross reference 
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Diagnostics and Statistics 

Figure 15 gives a detailed explanation of the diagnostics and statistics 
section of the listing. The following information may also be helpful 
in interpreting this section. 

The diagnostic messages issued by the assembler are fully documented in 
Appendix G of this manual. 

Error messages with the text IF0197 ***mnote*** indicate that an KNCTE 
message has been written in the source statement section cf the listing. 
The WNOTE message is given a statement number which is indicated 
together with this diagnostic message. 

Errors encountered during the processing of library macro definitions 
reference the END statement. (This is because library macros are read 
in by the assembler after the source cede.) However, if you specify the 
LIBMAC assembler option, all system macro definitions will be listed 
after the END statement; an error will then reference the statement 
within the macro definition that caused the error. 

To suppress error messages and MNOTE messages below a specified severity 
level, you can use the FLAG option. 
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r T M " i ' — K '" ; '' ' "■] 



The statement number of the statement flagged. 
For certain types of errors found in library 
macros, the statement number given is that of 
the END statement. For certain other types of 
errors the statement number given is zero, because 
the assembler cannot locate the statement in error. 









I The message identifier. It consists of 
the three characters IFO and three numeric 
characters giving a unique number to the 

I message. 

Jj-"':;"" 1 ".. ' '..«--. .."■■. ■. ■ '•■ -."<«: ••■-■■■.■■;■ ■■■: 



The total number of 
statements for which 
error messages were 
issued. 



i 




The text of the message. Many messages 
] include a segment of the error in the 
I statement or a pointer to the vicinity of 
1 the error. 




ASSEMBLER DIAGNOSTICS ANJifSTATISTICS 



MT 


ERROR CODE 





IFO076 


36 


IFO016 


65 


IFO090 


66 


IFO 197 


67 


IFO078 


7M 


IFO078 


88 


IF0196 


1«9 


IF0236 



MESSAGE 
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SEQUENCE SYMBOL .TYPECGK IS UNDEFINED IN MACRO M0VE 

ILLEGAL OR INVALID NAME FIELD /5' 

UNDEFINED SEQUENCE SYMBOL ENCOUNTERED DURING ^TONDITIONAL ASSEMBLY 

*♦* MNOTE ♦*♦ 

UNDEFINED OP CODE J' f " 

UNDEFINED OP CODE ,# 

MORE HAS BEEN PREVIOUSLY DEFINED jT* 

ILLEGAL CHARACTER IN EXPRESSION NEAR >£PERAND COLUMN 3 



NUMBER OF STATEMENTS FLAGGED IN THIS ASSEMBLY 
HIGHEST SEVERITY WAS 8«bsss*«»^ 
OPTIONS FOR THIS ASSEMBLY 

ALIGN, ALOGIC, BUFSIZE (STD) , NODECK, ESD, iflf 
NOMLOGIC, NONUMBER, NOOBJECT, NORENT, RLD, NOSTMT? 
SYSPARM 
WORK FILE BUFFER SIZE = 2558 

TOTAL RECORDS READ FROM SYSTEM INPUT 180 

TOTAL RECORDS READ FROM SYSTEM LIBRARY 
TOTAL RECORDS PUNCHED 

TOTAL RECORDS PRINTED 275 




Figure 15. Diagnostics and statistics 
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Programming Considerations 



The purpose of this section is to serve as a bridge between Assembler 
Language and other manuals that you will use frequently when programming 
in the assembler language. Among the topics discussed are: 

• Designing your program 

© Specifying the entry point into your program. 

• Linking with modules written in other programming languages. 

• Linking with processing programs. 



Designing Your Program 

When you design your program to run under VS, you must make sure that it 
follows the conventions required by that operating system. The minimum 
requirements for a very simple program are given in Figure 16. 

However, you will hardly ever write such a simple program and will 
therefore want to refer to the section "Program Design" in OS/VS 
Supervisor Services and Macro Instructions . Among the topics covered 
there are : 

• The linkage registers that the operating system uses in passing 
control between various components of the ccntrcl program, and 
between the control program and your problem prcgram. Ycu shculd 
use the same registers when calling your own programs. 

• Acquiring the information in the PARM field of the EXEC statement. 
In the same way as the assembler checks the options you specify for 
it in the PARM field, you can have your own program check the 
contents of that field. 

• Saving the calling program's registers, so that they are net 
modified by the called program. 

• Establishing a base register. 

• Providing a save area, so that any programs called by your prcgram 
can save the contents of your registers and restore the contents 
upon return. Note that certain system macro instructions (such as 
GET or PUT) call subroutines that assume that your program has 
provided a save area. 

• Virtual storage considerations. 

• Task creation. 
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The following coding shows the minimum number of instructions ycu 
need for a simple program. The program will be less than 4096 
bytes long and will consist of only one control section. It will 
not call any subroutines or use any other IEM-supplied macros 
than SAVE and RETURN. 



CSA 



SAVE 
USING 



ST 



(14,12) 
CSA f 15 



13,SAVE13 



Save registers for calling routine 
The control program passes control 
to the routine using register 15; 
use that register as a base 
Store address of calling routined 
save area 



(your program) 



SAVE 13 



L 13, SAVE 13 Reload address of save area 
RETURN (14,12) Return to calling routine in AOS 
ES F Space to save address of calling 

routine's save area 
(your constants and data areas) 

END 



Figure 16. Minimum requirements for a simple program 



Specifying the Entry Point into Your Program 



When your object module is link edited, either alone, or together with 
other modules, the entry point into the lead module produced is 
determined by the linkage editor. (The entry point is the address in 
the load module to which control is given by the control program, when 
the load module is to be executed.) 

Ycu can use the assembler END instruction or the linkage editor 
ENTRY control statement to specify the entry point to the linkage 
editor, as explained under "Output From The Linkage Editor" in linkage 
Editor and Loader. 



Linking with Modules Produced by other Language Translators 

The modules produced by the assembler can be combined with other modules 
by the linkage editor. These modules can be object modules or load 
modules, and may have been originally written in any of the languages 
supported by the operating system. This makes it possible for you to 
use different programming languages for different parts of your program, 
allowing each part to be written in the language best suited for it. 

However, when linking between modules produced by different language 
translators you must make sure that each module cenferirs to the data 
formats and linkage conventions required. If input/output operations 
are performed, ycu must also make sure that the appropriate DE 
statements are supplied for the data sets used in the different modules. 
For information on the requirements for linking between modules written 
in the assembler language and the problem-oriented languages, refer to 
the 'programmers guide for the particular compiler ycu are using. 



I. ; 
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Linking with IBM-Supplied Processing Programs 

You usually use the EXEC job control statement to load and give control 
to a processing program of the operating system. However, you can also 
load and give control to a sort program, a utility prcgram, or even a 
compiler "dynamically", that is, by using a system iracrc instruction 
(LINK, XCTL, CALL, or ATTACH) in your own program. When calling a 
program dynamically, make sure you follow the OS/VS linking conventions 
described under "Program Design" in OS/VS Supervisor Services and Macro 
Instructions . You must also pass certain parameters to the processing 
program. These parameters give the same information to the program as 
you would supply in job control statements, if you called the program 
with an EXEC statement. Appendix D describes how to call the assembler 
dynamically. Dynamic invocation of each of the other IEM-supplied 
processing programs is covered in one of the manuals describing that 
program. 
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Adding Macro Definitions to a Library 



You can include your own macro definitions or ether sections of 
often-used source cede in the system macro library or in a private 
library that you concatenate with the system macro library. A macro 
library can consist of both macro definitions and sections of code to be 
inserted by the COPY assembler instruction. 

You use the IEBUPDTE program to add members to a macro library. For 
further information on IEEUPETE and the utility ccntrcl statements 
needed, refer to OS/VS Utilities , Order No. GC35-0005. The following 
example shows how a new macro definition, NEWMAC, is added to the system 
macro library (SYS1.MACLIE) . 

//CATMAC JOB 1 2345, BROWN. JR,... 

//STEE1 EXEC PGM=IEEUPETE,PARM=MOD 

//SYSUT1 EE ESN=SYS1.MACLIB,EISP=0LD 

//SYSUT2 EE ESN=SYS1.MACLIB,DISP=0LD 

//SYS PRINT EE SYSOUT=A 

//SYS IN DD DATA 

./ AEE LIST=ALL,NAME=NEWMAC,LEVEL=01,£OURCE=0 

MACRO 

NEWMAC S0P1,S0P2 

LCLA SPAR1,SPAR2 



-/ 
/* 



MEND 
ENDUP 



The SYSUT1 and SYSUT2 DD statements indicate that SYS1.MACLIE, an 
existing program library, is to be updated. Output freir the IEEUPETE 
program is printed on the Class A output device (specified by SYSPRINT) . 
The utility control statement ./ AEE and the macrc definition fellow the 
SYSIN statement. The ./ ADD statement specifies that the statements 
following it are to be added to the macrc library under the name NEWMAC. 
When you include macro definitions in the library, the name specified in 
the NAME parameter of the ./ AEE statement must be the same as the 
operation cede of the macro definition,. 
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Appendix A. Glossary 



The following terms are defined as they are used in this rranual. If you 
do net find the terir ycu are looking for, refer to the Index cr to the 
IBM Cata Proc essing Gl ossary , Crder No. GC20-1699. 

The terras are of three different kinds: 

• Definitions made by the American National Standards Institute 

(ANSI) . Such definitions are marked by an asterisk (*) . 

• Definitions valid for OS. Such definitions are irarked by an C. 

• Definitions of terirs that are used in describing the legic cf the CS 
Assembler. They are included here only because they are used in the 
assembler diagnostic messages. For further infcriraticn en these 
terms, refer tc OS /VS Assembler Logic , SY33-8041. Such definitions 
are marked by an A. 

IEtf is grateful to the American National Standards Institute 
(ANSI) fcr permission to reprint its definitions from the 
American National Standard Vocabulary fcr Infcriraticn 
Processing, which was prepared by Subcommittee X3K5 on 
Terminology and Glossary of American Naticnal Standards 
Ccrrrrittee X3. 

This glessary dees not explain terms pertaining to the assembler 
language. Such terms are covered in the glessary cf Asseirb ler language . 

assemble : To prepare a machine language prcgrarr f rcrr a syrrbclic language 
program by substituting machine operation codes for symbolic operation 
codes and absolute or relocatable addresses fcr symbolic addresses. 

• assembler : A computer program that assembles. 

assembler instruction : An assembler language source statement that 
causes the assembler to perform a specific operation. Assembler 
instructiens are net translated into machine instructions. 

assembler language: A source language that includes syrrbclic rrachine 
language statements in which there is a one-to-one correspondence with 
the instruction formats and data formats of the computer. The assembler 
language also contains statements that represent asseirbler instructions 
and macro instructiens. 

assembler option : A function of the assembler requested fcr a particular 
job step. 

auxiliary storage : Online storage other than main storage; for example 
storage on magnetic tapes or on direct access devices. 

catalcged procedure : A set cf job control statements that has been 
placed in a partitioned data set called the procedure library, and can 
be retrieved by naming it in an execute (EXEC) stateirer.t cr started by 
the START ccmrrand. 

concatenated data sets : A group of logically connected data sets that are 
treated as cne data set fcr the duration of a job step. 

• control program : A program that is designed to schedule and supervise 
the performance of data processing work by a cemputing system. 

Appendix A. Glessary 51 



control section : That part of a program specified by the programmer to 
be a relocatable unit, all elements of which are to be leaded intc 
adjoining main storage locations. 

data set : The major unit of data storage and retrieval in the operating 
system, consisting of a collection of data in one of several prescribed 
arrangements and described by control information to which the system 
has access. 

• diagnostic : Pertaining to the detection and isolation cf a malfunction or 
mistake. 

A edited text : Source statements modified by the assembler for internal 
use. The initial processing of the assembler is referred to as editing. 

O entry point : A location in a module to which control can be passed from 
another module or from the control program. 

ESP : (See external symbol dictionary) 

execute (EXEC) statement : A job control language (JCL) statement that 
marks the beginning of a job step and identifies the program to be 
executed or the cataloged or in-stream procedure to be used. 

external symbol dictionary (ESE) : Control information associated with an 
object or load module which identifies the external symbols in the 
module. 

A global dictionary : An internal table used by the assembler during macro 
generation to contain the current values of all unique global SETA, 
SETE, and SETC variables from all text segments. 

A global vector table : A table of pointers in the skeleton dictionary of 
each text segment showing where the global variables are located in the 
global dictionary. 

input stream : The sequence of job control statements and data submitted 
to an operating system on an input unit especially activated for this 
purpose by the operator. 

instruction : 

* 1. A statement that specifies an operation and the values and 

locations of its operands. 

2. (See assembler instruction, machine instruction, and macro 
instruction) 

JCL : (See job control language) 

* job : A specified group of tasks prescribed as a unit of work for a 
computer. Ey extension, a job usually includes all necessary computer 
programs, linkages, files, and instructions to the operating system. 

job control language (JCL) : A language used to code job control 
statements. 

• job control statement : A statement in a job that is used in identifying 
the job or describing its requirements to the operating system. 

job step : 

* 1 . The execution cf a computer program explicitly identified by a 

job control statement. A job may specify that several job steps 
be executed. 
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2. A unit of work associated with one processing program or one 

cataloged procedure and related data. A job consists cf one or 
more job steps. 

jobnaroe : The name assigned to the JOB statement; it identifies the job 
to the system . 

• language : A set of representations, conventions, and rules used to 
convey information. 

language translator : A general term for any assembler, compiler, cr 
other routine that accepts statements in one language and produces 
equivalent statements in another language. 

library ; (See partitioned data set) 

library macro definition : A macro definition that is stored in a macro 
library. The IBM-supplied supervisor and data management macro 
definitions are examples cf library macro definitions. 

O linkage editor : A processing program that prepares the output cf 
language translators for execution. It combines separately produced 
object or load modules; resolves symbolic cross references among them; 
replaces, deletes, and adds control sections; and generates overlay 
structures on request; and produces executable code (a load mcdule) that 
is ready to be fetched into main storage and executed. 

linking conventions : A set of conventions for passing control between 
different routines of the operating system. 

load irodule : The output of a single linkage editor execution. A lead 
module is in a format suitable for loading into virtual storage for 
execution. 

load module library : A partitioned data set that is used to store and 
retrieve load modules. 

loader : A processing program that performs the basic editing functions 
of the linkage editor, and also fetches and gives control to the 
processed program, all in one job step. It accepts object modules and 
load modules created by the linkage editor and generates executable cede 
directly in storage. The loader does not produce load modules for 
program libraries . 

A local dictionary : An internal table used by the assembler during macro 
generation to contain the current values of all lecal SET symbols. 
There is one local dictionary for open code, and cne fcr each macro 
definition. 

location counter : A counter whose value indicates the assembled address 
of a machine instruction or a constant or the address of an area of 
reserved storage, relative to the beginning of the control section. 

• machine instruction : An instruction that a machine can recognize and 
execute. 

• machine language : A language that is used directly by the machine. 

macro : (See macro instruction and macro definition) 

macro call : (See macro instruction) 

macro definition ; A set of statements that defines the name of, format 
of, and conditions for generating a sequence of assembler language 
statements frcm a single source statement. This statement is a macro 
instruction that calls the definition. (See also library macro 
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definition and source macro definition) 

macro expansion ; (See macro generation) 

macro generation (macro expansion) ; An operation in which the assembler ^ -^ 
generates a sequence of assembler language statements frcm a single [ 

macro instruction, under conditions described by a macro definition. 

macro instruction (macro call) : An assembler language statement that 
causes the assembler to process a predefined set cf statements called a 
macro definition. 

macro library ; A library containing macro definitions. The supervisor 
and data management macro definitions supplied by IBM (GET, LINK, etc.) 
are contained in the system macro library. Private macro libraries can 
be concatenated with the system macro library. 

main storage : All program addressable storage from which instructions 
may be executed and from which data can be leaded directly intc 
registers. 

module ; (see load module, object module, and source module) 

object module ; The machine- language output of a single execution of an 
assembler or a compiler. An object module is used as input tc the 
linkage editor or leader. 

* online storage ; Storage under the control of the central processing unit. 

open code ; The portion cf a source module that lies cutside cf and after 
any source macro definitions that may be specified. 

• operating system : Software which controls the execution of computer 
programs and which may provide scheduling, debugging, input/output 

control, accounting, compilation, storage assignment, data management, ^— -^ 

and related services. 

A ordinary symbol attribute reference dictionary : A dictionary used by the 
assembler. The assembler puts an entry in it for each ordinary symbol 
encountered in the name field of a statement. The entry contains the 
attributes (type, length, etc.) of the symbol. 

option : (See assembler option) 

partitioned data set (library) : A data set in direct access storage that 
is divided into partitions, called members, each cf which can contain a 
program or a part of a program. Each partitioned data set contains a 
directory (or index) that the control program can use to locate a 
program in the partitioned data set. 

O procedure step : A unit of work associated with one processing program 
and related data within a cataloged procedure. A cataloged procedure 
consists cf one or more procedure steps. 

O processing program : 

1. A general term for any program that is not a control program. 

2. Any program capable of operating in the problem program state. 
This includes IBW-distributed language translators, application 
programs, service programs, and user-written programs. 
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program : 

1 . A general term for any combination cf statements that can be 
interpreted by a computer or language translator, and that 
serves to perform a specific function. 

2. To write a program. 

programmer macro definition ; (See source macro definition) 

real storage ; The storage of a System/370 computer frcm which the 
central processing unit can directly obtain instructions and data and to 
which it can directly return results. 

• relocation dictionary : The part of an object or lead ncdule that 
identifies all addresses that must be adjusted when a relocation occurs. 

return code ; P. value placed in the return code register at the 
completion cf a program. The value is established by the user and may 
be used to influence the execution of succeeding programs or, in the 
case of an abnormal end of task, may simply be printed fcr programmer 
analysis. 

sequential data set : P. data set whose records are organized en the basis 
of their successive physical positions such as on magnetic tape. 

severity cede : A cede assigned by the assembler to each error detected 
in the source code. The highest code encountered during assembly becomes 
the return cede of the assembly step. 

A skeleton dictionary : P dictionary built by the assembler fcr each text 
segment. It contains the global vector, the sequence symbol reference 
dictionary, and the local dictionary. 

source macro definition : A macro definition included in a source module, 
either physically or as the result of a COPY instruction. 

o source module : The source statements that constitute the input to a 
language translator for a particular translation. 

source statement : P. statement written in symbols cf a programming 
language. 

• statement : P. meaningful expression or generalized instruction in a 
source language. 

step : (See job step and procedure step) 

stepname : The name assigned to an execute (EXEC) statement. It 
identifies a job step within a job. 

symbolic parameter : 

1. In JCL, a symbol preceded by an ampersand that appears in a 
cataloged procedure. Values are assigned tc symbolic parameters 
when the procedure in which they appear is called. 

2. In assembler programming, a variable symbol declared in the 
prototype statement of a macro definition. 

A symbol file : A data set used by the assembler for symbol definitions and 
references and literals. 

system macro definition : Loosely, an IBM-supplied library macro 
definition which provides access to operating system facilities. 
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* terminal . A point in a system or communication network at which data can 
either enter cr leave or both. 

A text segment . The range over which a local dictionary has meaning. The 
source module is divided into text segments with a segment for open code 
and one for each macro definition. 

* transform. To change the form of data according to specific rules. 

* translate. To transform statements from one language into another 
without significantly changing the meaning. 

virtual storage. Address space appearing to the user as real storage 
from which instructions and data are mapped into real storage locations. 
The size of virtual storage is limited ty the addressing scheme of the 
computing system and by the amount of auxiliary storage available, 
rather than by the actual number of real storage lccaticns. 
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Appendix B. Assembler Sample Program 



The sample program shown in Figure 17 can be used as a test of the 
functioning of the assembler after your system has been generated (see 
0S/VS1 System Generation Reference , Order No. GC26-3791). It also serves 
serves as a good example of assembler language coding and of the 
listing produced by the assembler. 

The program illustrates the definition and use of user-written macro 
instructions, use of IEM-supplied iracrc instructions, use cf dummy 
control sections, and the method of saving and restoring registers upon 
entry to and exit from a program. 

The data tc be processed is assembled as part of the program. It 
consists of a table and a list of entries that are compared with the 
table. Each item in the table contains an argument name (such as AIFHA) 
and space in which information concerning the name is to be placed. 
Each entry in the list contains an argument name and function values. 
The formats of the table entries and the list entries are different, and 
both formats are described in dummy sections. 

The program searches the table for an argument name in the list. If a 
match is found, the function values are reformatted and moved to the 
appropriate table entry. If an argument name in the list cannct be 
found in the table, a switch is set in the list entry. .After all the 
list entries have been processed, the list area and the table area are 
compared with a table and a list containing the predefined results. If 
the tables and lists are equal, the routine executed properly, and a 
message is written on the operator's ccnscle to indicate this. 



IFOSAMP 






EXTERNAL SYMBOL DICTIONARY 


PAGE 1 


SYMBOL 


TYPE ID 


AEDR LENGTH LDID 




ASM 0100 15.00 01/03/72 


SAMPLR 


SD 0001 


000000 0003C0 






—- -—_____ 




_^~~— "— — " 















Figure 17. Assembler sample program 
(Part 1 cf 11) 
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IFOSAMP - SAMPLE PROGRAM 








PAGE 2 


LOC OBJECT CODE ADDR1 ADDR2 


STMT 


SOURCE 


STATEMENT ASM 0100 15.00 


01/03/72 




2 




PRINT DATA 


SAMPL002 




3 


* 




SAMPL003 




4 


* 


THIS IS THE MACRO DEFINITION 


SAMPL004 




5 


* 




SAMPL005 




6 




MACRO 


SAMPL006 




7 




MOVE STO,SFROM 


SAMPL007 




8 


.* 




SAMPL008 




9 


.* 


DEFINE SETC SYMBOL 


SAMPL009 




10 


.# 




SAMPL010 




11 




LCLC . STYPE 


SAMPL011 




12 


.* 




SAMPL012 




13 


.# 


CHECK NUMBER OF OPERANDS 


SAMPL013 




14 


.* 




SAMPL014 




15 




AIF (N'SSYSLIST NE 2) .ERROR 1 


SAMPL015 




16 


.* 




SAMPL016 




17 


.* 


CHECK TYPE ATTRIBUTES OF OPERANDS 


SAMPL017 




18 


.# 




SAMPL018 




19 




AIF (T'STO NE T'SFROM) .ERROR2 


SAMPL019 




20 




AIF CT'STO EQ 'C OR T'STO EQ 'G' OR T'STO EQ ^K') .TYPECGK 


SAMPL020 




21 




AIF (T'STO EQ 'D' OR T'STO EQ 'E' OR T'STO EQ 'H') .TYPEDEH 


SAMPL021 




22 




AIF (T'STO EQ 'F') -MOVE 


SAMPL022 




23 




AGO .ERROR3 


SAMPL023 




24 


.TYPEDEH 


ANOP 


SAMPL024 




25 


.♦ 




SAMPL025 




26 


.* 


ASSIGN TYPE ATTRIBUTE TO SETC SYMBOL 


SAMPL026 




27 


.# 




SAMPL027 




28 


(TYPE 


SETC T'STO 


SAMPL028 




29 


.MOVE 


ANOP 


SAMPL029 




30 


* 


NEXT TWO STATEMENTS GENERATED FOR MOVE MACRO 


SAMPL030 




31 




LSTYPE 2, (FROM 


SAMPL031 




32 




STSTYPE 2, (TO 


SAMPL032 




33 




MEXI1 


SAMPL033 




34 


.# 




SAMPL034 




35 


.♦ 


CHECK LENGTH ATTRIBUTES OF OPERANDS 


SAMPL035 




36 


.* 




SAMPL036 




37 


•TYPECGK 


AIF (L'STO NE L'SFROM OR L'STO GT 256) .ERROR4 


SAMPL037 




38 


* 


NEXT STATEMENT GENERATED FOR MOVE MACRO 


SAMPL038 




39 




MVC STO.SFROM 


SAMPL039 




40 




MEXIT 


SAMPL040 




41 


.♦ 




SAMPL041 




42 


.* 


ERROR MESSAGES FOR INVALID MOVE MACRO INSTRUCTIONS 


SAMPL042 




43 


.♦ 




SAMPL043 




44 


.ERROR1 


MNOTE 1,' IMPROPER NUMBER OF OPERANDS, NO STATEMENTS GENERATED" 


SAMPL044 




45 




MEXIT 


SAMPL045 




46 


. ERROR2 


MNOTE 1, 'OPERAND TYPES DIFFERENT, NO STATEMENTS GENERATED' 


SAMPL046 




47 




MEXIT 


SAMPL047 




48 


. ERROR3 


MNOTE 1,' IMPROPER OPERAND TYPES, NO STATEMENTS GENERATED' 


SAMPL048 




49 




MEXIT 


SAMPL049 




50 


•ERROR4 


MNOTE 1, 'IMPROPER OPERAND LENGTHS, NO STATEMENTS GENERATED' 


SAMPL050 




51 




MEND 


SAMPL051 




52 


• 




SAMPL052 




53 


* 


MAIN ROUTINE 


SAMPL053 




54 


* 




SAMPL054 


000000 


55 


SAMPLR 


CSECT 


SAMPL055 




56 


BEGIN 


SAVE (14,12),,* ^ . 


SAMPL056 









r 



Figure 17. 



Assembler sample 
(Part 2 of. 11) 



program 



58 



IFOSAMP 


SAMPLE PROGRAM 










PAGE 3 


LOC 


OBJECT CODE 


ADDR1 


ADDR2 


STMT SOURCE 


STATEMENT ASM 0100 15.00 


01/03/72 


000000 


47F0 


FOOA 


OOOOA 




57+BEGIN 


B 


10(0,15) BRANCH AROUND ID 


00860000 


000004 


05 








58 + 


DC 


AL1 (5) 


00880000 


000005 


C2C5C7C9D5 






59* 


DC 


CL5 'BEGIN' IDENTIFIER 


00900000 


00000A 


90EC 


DOOC 


OOOOC 




60 + 


STM 


14,12,12(13) SAVE REGISTERS 


01180000 


00000E 


05C0 








61 


BALR 


R12.0 ESTABLISH ADDRESSABILITY OF PROGRAM 


SAMPL057 










00010 


62 


USING 


♦,R12 AND TELL THE ASSEMBLER WHAT BASE TO USE 


SAMPL058 


000010 


50D0 


COCO 


OOODO 




63 


ST 


13,SAVE13 


SAMPL059 


000014 


9857 


C398 


003A8 




64 


LM 


R5,R7,=A(LISTAREA,16,LISTEND) LOAD LIST AREA PARAMETERS 


SAMPL060 










00000 


65 


USING 


LIST,R5 REGISTER 5 POINTS TO THE LIST 


SAMPL061 


000018 


45E0 


C0C6 


000D6 




66 MORE 


BAL 


R1 4, SEARCH FIND LIST ENTRY IN TABLE 


SAMPL062 


00001C 


9180 


C0C4 


000D4 




67 


TM 


SWITCH, NONE CHECK TO SEE IF NAME WAS FOUND 


SAMPL063 


000020 


4710 


C0B6 


000C6 




68 


BO 


NOTTHERE BRANCH IF NOT 


SAMPL064 










00000 


69 
70 
71+* 


USING 

MOVE 

NEXT 


TABLE, R1 REGISTER 1 NOW POINTS TO TABLE ENTRY 
TSWITCH.LSWITCH MOVE FUNCTIONS 
STATEMENT GENERATED FOR MOVE MACRO 


SAMPL065 
SAMPL066 
SAMPL038 


000024 


D200 


1003 5008 


00003 


00008 


72+ 

73 

74+* 


MVC 

MOVE 

NEXT 


TSWITCH.LSWITCH 

TNUMBER.LNUMBER FROM LIST ENTRY 
STATEMENT GENERATED FOR MOVE MACRO 


SAMPL039 
SAMPL067 
SAMPL038 


00002A 


D202 


1000 5009 


00000 


00009 


75 + 

76 

77+* 


MVC 

MOVE 

NEXT 


TNUMBER,LNUMBER 

TADDRESS,LADDRESS TO TABLE ENTRY 
TWO STATEMENTS GENERATED FOR MOVE MACRO 


SAMPL039 
SAMPL068 
SAMPL030 


000030 


5820 


500C 


OOOOC 




78 + 


L 


2,LADDRESS 


SAMPL031 


000034 


5020 


1004 


00004 




79 + 


ST 


2, T ADDRESS 


SAMPL032 


000038 


8756 


C008 


00018 




80 LISTLOOP 


BXLE 


R5,R6,MORE LOOP THROUGH THE LIST 


SAMPL069 


00003C 


D5EF 


C248 C0F8 


00258 


00108 


81 


CLC 


TESTTABL(240) ,TABLAREA 


SAMPL070 


000042 


4770 


C080 


00090 




82 


BNE 


NOTRIGHT 


SAMPL071 


000046 


D55F 


C338 C1E8 


00348 


001F8 


83 


CLC 


TESTLIST(96) ,LISTAREA 


SAMPL072 


00004C 


4770 


C080 


00090 




84 
85 


BNE 
WTO 


NOTRIGHT 

•SAMPLE PROGRAM IFOSAMP SUCCESSFUL' ,ROUTCDE= (2,1 1) 


SAMPL073 
SAMPL074 


000050 










86 + 


CNOP 


0,4 


00480000 


000050 


4510 


C06E 


0007E 




87+ 


BAL 


1,IHB0005A BRANCH AROUND MESSAGE 


00500000 


000054 


0025 








88+ 


DC 


AL2 (IHB0005-*) MESSAGE LENGTH 


00428018 


000056 


8000 








89+ 


DC 


B* 1000000000000000' MCSFLAGS FIELD 


00428818 


000058 


E2C1D4D7D3C540D7 




90 + 


DC 


C" SAMPLE PROGRAM IFOSAMP SUCCESSFUL" MESSAGE 


00429618 


000060 


D9D6C7D9C1D440C9 












000068 


C6D6E2C1D4D740E2 












000070 


E4C3C3C5E2E2C6E4 












000078 


D3 
























00079 


91+IHB0005 


EQU 


* 


00430418 


000079 


0000 








92+ 


DC 


B'0000000000000000' DESCRIPTOR CODES 


00432018 


00007B 


4020 








93+ 


DC 


B' 0100000000 100000' ROUTING CODES 


00432818 


00007E 










94+IHB0005A 


DS 


OH 


00560000 


00007E 


0A23 








95+ 


SVC 


35 ISSUE SVC 


00600000 


000080 


58D0 


COCO 


OOODO 




96 EXIT 


L 


R13,SAVE13 


SAMPL075 












97 


RETURN (14,12) ,RC=0 


SAMPL076 


000084 


98EC 


DOOC 


OOOOC 




98+ 


LM 


14,12,12(13) RESTORE THE REGISTERS 


00260000 


000088 


41F0 


0000 


00000 




99+ 


LA 


15,0(0,0) LOAD RETURN CODE 


00700000 


00008C 


07FE 








100+ 

101 * 

102 NOTRIGHT 


BR 
WTO 


14 RETURN 

•SAMPLE PROGRAM IFOSAMP UNSUCCESSFUL" ,ROUTCDE= (2,11) 


00800000 
SAMPL077 
SAMPL078 


00008E 


0700 








103+ 


CNOP 


0,4 


00480000 


000090 


4510 


COBO 


OOOCO 




104+NOTRIGHT 


BAL 


1,IHB0007A BRANCH AROUND MESSAGE 


00500000 


000094 


0027 








105+ 


DC 


AL2 (IHB0007-*) MESSAGE LENGTH 


00428018 


000096 


8000 








106+ 


DC 


B* 1000000000000000' MCSFLAGS FIELD 


00428818 


000098 


E2C1D4D7D3C540 


37 




107 + 


DC 


C SAMPLE PROGRAM IFOSAMP UNSUCCESSFUL" MESSAGE 


00429618 


. 












■ 





Figure 17. Assembler sample program 
(Part 3 cf 11) 
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- SAMPLE PROGRAM 



LOC OBJECT CODE 



ADDR1 ADDR2 STMT SOURCE STATEMENT 



ASM 0100 15.00 01/03/72 



0000A0 D9D6C7D9C1D440C9 
0000A8 C6D6E2C1D4D740E4 
0000B0 D5E2E4C3C3C5E2E2 
0000B8 C6E4D3 



0000BB 0000 




0000BD 4020 




0000C0 




000OC0 0A23 




0000C2 47F0 C070 


00080 


0000C6 9680 5008 


00008 


0000CA 47F0 C028 


00038 


0000CE 0000 




00O0DO 00000000 




00O0D4 00 





0000D5 00 
0000D6 947F C0C4 
0000DA 9813 C3A4 
0000DE 4111 C0E8 
0000E2 8830 0001 



0OOD4 
003B4 
000F8 
00001 



0000E6 D507 5000 1008 00000 00008 
0000EC 4720 COEC 000FC 
OOOOFO 078E 
0000F2 1B13 



0000F4 4620 C0D2 
0000F8 47F0 C0F2 
OOOOFC 1A13 
OOOOFE 4620 C0D2 
000102 9680 C0C4 
000106 07FE 



000E2 
00102 



000E2 
000D4 



000108 
000108 
000110 
000118 
000120 
000128 
000130 
000138 
000140 
000148 
000150 
000158 
000160 
000168 
000170 
000178 
000180 



0000000000000000 
C1D3D7C8C1404040 
0000000000000000 
C2C5E3C140404040 
0000000000000000 
C4C5D3E3C1404040 
0000000000000000 
C5D7E2C9D3D6D540 
0000000000000000 
C5E3C14040404040 
0000000000000000 
C7C1D4D4C1404040 
0000000000000000 
C9D6E3C140404040 
0000000000000000 
D2C1D7D7C1404040 



108+IHB0007 EQU 

109* DC 

110+ DC 

11HIHB0007A DS 

112+ SVC 

113 B 

114 NOTTHERE 01 

115 B 



DESCRIPTOR CODES 
ROOTING CODES 



116 SAVE13 

117 SWITCH 

118 NONE 

119 * 

120 * 

121 ♦ 

122 SEARCH 
123 

124 

125 LOOP 

126 

127 

128 

129 



DC 
DC 
EQU 



B'0000000000000000' 

B'0100000000100000" 

OH 

35 ISSUE SV 

EXIT 

LSWITCH.NONE TURN ON SWITCH IN LIST ENTRY 

LISTLOOP GO BACK AND LOOP 

F'O" 

X'OO' 

X'80' 



BINARY SEARCH ROUTINE 



NI 

LM 

LA 

SRL 

CLC 

BH 

BCR 

SR 



SWITCH, 255-NONE TURN OFF NOT FOUND SWITCH 
R1,R3,=F' 128,4, 128' LOAD TABLE PARAMETERS 
R1,TABLAREA-16 (R1) GET ADDRESS OF MIDDLE ENTRY 



130 BCT 

131 B 

132 HIGHER AR 

133 BCT 

134 NOTFOUND 01 

135 BR 

136 * 

137 ♦ THIS 

138 ♦ 

139 DS 

140 TABLAREA DC 



R3.1 

LNAME,TNAME 
HIGHER 
8,R14 
R1.R3 

R2,LO0P 

NOTFOUND 

R1.R3 

R2,LOOP 

SWITCH, NONE 

R14 

IS THE TABLE 

OD 
XLa'O'.CLa'ALPHA' 



DIVIDE INCREMENT BY 2 

COMPARE LIST ENTRY WITH TABLE ENTRY 

BRANCH IF SHOULD BE HIGHER IN TABLE 

EXIT IF FOUND 

OTHERWISE IT IS LOWER IN THE TABLE 

SO SUBTRACT INCREMENT 
LOOP 4 TIMES 

ARGUMENT IS NOT IN THE TABLE 
ADD INCREMENT 
LOOP 4 TIMES 
TURN ON NOT FOUND SWITCH 
EXIT 



141 
142 
143 
144 
145 
146 
147 



DC XLS'O'.CLe'BETA 1 

DC XLS'O'.CLa'DELTA' 

DC XLS'O^CLS'EPSILON' 

DC XLS'O'.CLS'ETA" 

DC XLS'O'jCLa'GAMMA' 



00430418 
00432018 
00432818 
00560000 
00600000 
SAMPL079 
SAMPL080 
SAMPL081 

SAMPL082 
SAMPL083 
SAMPL084 
SAMPL085 
SAMPL086 
SAMPL087 

SAMPL0 88 
SAMPL089 
SAMPL090 
SAMPL091 
SAMPL092 
SAMPL093 
SAMPL094 
XSAMPL095 
SAMPL096 
SAMPL097 
SAMPL098 
SAMPL099 
SAMPL100 
SAMPL101 
SAMPL102 
SAMPL103 
SAMPL104 
SAMPL105 
SAMPL106 
SAMPL107 

SAMPL108 

SAMPL109 

SAMPL110 

SAMPL111 

SAMPL112 



DC 
DC 



XLa'O'.CLa'IOTA 1 
XLS'O'.CLS" KAPPA' 




Figure 17. 



Assembler sample 
(Part 4 of 11) 



program 
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IFOSAMP 



SAMPLE PROGRAM 



LOC OBJECT CODE 



ADDR1 ADDR2 



000188 
000190 
000198 
0001A0 
0001A8 
0001B0 
0001B8 
0001C0 
0001C8 
0001D0 
0001D8 
0001E0 
0001E8 
0001FO 



0001F8 
000200 
000208 
000210 
000218 
000220 
000228 
000230 
000238 
000240 
000248 
000250 



000258 
300258 
300260 
000268 
300270 
000278 
300280 
000288 
300290 
000298 
3002A0 
0002A8 
3002B0 
3002B8 
3002C0 
0002C8 
3002D0 
0002D8 
3002E0 
3002E8 
3002F0 
3002F8 
300300 



0000000000000000 
D3C1D4C2C4C14040 
0000000000000000 
D4E4404040404040 
0000000000000000 
D5E4404040404040 
0000000000000000 
D6D4C9C3D9D6D540 
0000000000000000 
D7C8C94040404040 
0000000000000000 
E2C9C7D4C1404040 
0000000000000000 
E9C5E3C140404040 



D3C1D4C2C4C14040 
OA00001DOOOOOOOO 
E9C5E3C140404040 
05000005000000E2 
E3C8C5E3C1404040 
02000O2DOO000OO0 
E3C1E44040404040 
0000000000000001 
D3C9E2E340404040 
1F0001D100000000 
C1D3D7C8C1404040 
000000010000007B 



000001000000007B 
C1D3C7C8C1404040 
0000000000000000 
C2C5E3C140404040 
0000000000000000 
C4C5D3E3C1404040 
0000000000000000 
C5D7E2C9D3D6D540 
0000000000000000 
C5E3C14040404040 
0000000000000000 
C7C1D4D4C1404040 
0000000000000000 
C9D6E3C140404040 
0000000000000000 
D2C1D7D7C1404040 
00001DOAOOOOOOOO 
D3C1D4C2C4C14040 
0000000000000000 
D4E4404040404040 
0000000000000000 
D5E4404040404040 



STMT SOURCE 
148 
149 
150 
151 
152 
153 
154 

155 * 

156 * 

157 * 

158 LISTAREA 

159 
160 
161 
162 

163 LISTEND 

164 * 

165 * 

166 * 
167 

168 TESTTABL 

169 
170 
171 
172 
173 
174 
175 
176 
177 
178 



STATEMENT ASM 0100 15. 

DC XL8*0' ,CL8 'LAMBDA' 

DC XL8'0',CL8'MU' 

DC XLS'O'jCLS'NU' 

DC XLS'O'.CLS'OMICRON' 

DC XL8'0',CL8'PHI' 

DC XL8'0',CL8' SIGMA' 

DC XL8'0',CL8'ZETA' 

THIS IS THE LIST 

DC CLS'LAMBDA 1 .X'OA' fFLl'lS' ,A (BEGIN) 

DC CLS'ZETA'.X'OS'fFLS'S'.AfLOOP) 

DC CL8'THETA' ,X' 02' ,FL3' 45' ,A (BEGIN) 

DC CL8'TAU',X'00' ,FL3'0',A(1) 

DC CLS'LIST'.XMF'.FLS^eS'.AtO) 

DC CL8'ALPHA' ,X'00' ,FL3* 1 ' ,A (123) 

THIS IS THE CONTROL TABLE 

DS 0D 

DC FL3' 1',X'00',A (123) ,CL8'ALPHA' 

DC XL8'0',CL8'BETA' 

DC XL8'0',CL8'DELTA' 

DC XL8'0',CL8'EPSILON' 

DC XL8'0',CL8'ETA' 

DC XLS'O'fCLS'GAMMA' 

DC XL8'0',CL8'IOTA' 

DC XL8'0' ,CL8 'KAPPA' 

DC FL3'29" ,X'0A',A (BEGIN) ,CL8'LAMBDA" 

DC XL8'0',CL8'MU' 

DC XL8'0',CL8'NU' 



PAGE 5 

00 01/03/72 

SAMPL115 

SAMPL116 

SAMPL117 

SAMPL118 

SAMPL119 

SAMPL120 

SAMPL121 

SAMPL122 
SAMPL123 
SAMPL124 
SAMPL125 

SAMPL126 

SAMPL127 

SAMPL128 

SAMPL129 

SAMPL130 

SAMPL131 
SAMPL132 
SAMPL133 
SAMPL134 
SAMPL135 

SAMPL136 

SAMPL137 

SAMPL138 

SAMPL139 

SAMPL140 

SAMPL141 

SAMPL142 

SAMPL143 

SAMPL144 

SAMPL145 



Figure 17. Assembler sample program 
(Part 5 cf 11) 
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IFOSAMP - SAMPLE PROGRAM 
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LOC 


OBJECT CODE ADDR1 


ADDR2 


STMT SOURCE 


STATEMENT ASM 0100 15.0C 


01/03/72 


000308 


0000000000000000 




179 


DC 


XLS'O'jCLS'OMICRON" 


SAMPL146 


000310 


D6D4C9C3D9D6D540 












000318 


0000000000000000 




180 


DC 


XLe'OSCLa'PHI' 


SAMPL147 


000320 


D7C8C94040404040 












000328 


0000000000000000 




181 


DC 


XLS'O'.CLS' SIGMA' 


SAMPL148 


000330 


E2C9C7D4C1404040 












000338 


00000505000000E2 




182 


DC 


FLS'S'jX'OS'jAfLOOP) jCLS'ZETA' 


SAMPL149 


000340 


E9C5E3C140404040 




183 * 






SAMPL150 








184 * 


THIS 


IS THE CONTROL LIST 


SAMPL151 








185 * 






SAMPL152 


000348 


D3C1D4C2C4C14040 




186 TESTLIST 


DC 


CL8'LAMBDA' ,X' OA" ,FL3' 29' ,A (BEGIN) 


SAMPL153 


000350 


0A00001D00000000 


- 










000358 


E9C5E3C140404040 




187 


DC 


CLS'ZETA' ,X'05' ,FL3'5' ,A (LOOP) 


SAMPL154 


000360 


05000005000000E2 












000368 


E3C8C5E3C1404040 




188 


DC 


CLS'THETA' ,X« 82* ,FL3' 45' ,A (BEGIN) 


SAMPL155 


000370 


8200002D00000000 












000378 


E3C1E44040404040 




189 


DC 


CL8 , TAU , ,X , 80 , ,FL3'0 , ,A(1) 


SAMPL156 


000380 


8000000000000001 












000388 


D3C9E2E340404040 




190 


DC 


CLS'LIST 1 ,X'9F' ,FL3 , 465',A (0) 


SAMPL157 


000390 


9F0001D100000000 












000398 


C1D3D7C8C1404040 




191 


DC 


CLS'ALPHA' ,X'00' ,FL3' 1 • ,A (123) 


SAMPL158 


0003A0 


000000010000007B 




192 * 






SAMPL159 








193 * 


THESE 


ARE THE SYMBOLIC REGISTERS 


SAMPL160 








194 * 






SAMPL161 






00000 


195 RO 


EQU 





SAMPL162 






00001 


196 R1 


EQU 


1 


SAMPL163 






00002 


197 R2 


EQU 


2 


SAMPL164 






00003 


198 R3 


EQU 


3 


SAMPL165 






00005 


199 R5 


EQU 


5 


SAMPL166 






00006 


200 R6 


EQU 


6 


SAMPL167 






00007 


201 R7 


EQU 


7 


SAMPL168 






ooooc 


202 R12 


EQU 


12 


SAMPL169 






0000D 


203 R13 


EQU 


13 


SAMPL170 






0000E 


204 R14 


EQU 


14 


SAMPL171 






0000F 


205 R15 

206 * 


EQU 


15 


SAMPL172 
SAMPL173 








207 * 


THIS 


IS THE FORMAT DEFINITION OF -LIST ENTRYS 


SAMPL174 








208 * 






SAMPL175 


000000 






209 LIST 


DSECT 




SAMPL176 


000000 






210 LNAME 


DS 


CL8 


SAMPL177 


000008 






211 LSWITCH 


DS 


C 


SAMPL178 


000009 






212 LNUMBER 


DS 


FL3 


SAMPL179 


OOOOOC 






213 LADDRESS 

214 * 


DS 


F 


SAMPL180 
SAMPL181 








215 * 


THIS 


IS THE FORMAT DEFINITION OF TABLE ENTRYS SAMPL182 








216 * 






SAMPL183 


000000 






217 TABLE 


DSECT 




SAMPL184 


000000 






218 TNUMBER 


DS 


FL3 


SAMPL185 


000003 






219 TSWITCH 


DS 


C 


SAMPL186 


000004 






220 TADDRESS 


DS 


F 


SAMPL187 


000008 






221 TNAME 


DS 


CL8 


SAMPL188 


000000 






222 


END 


BEGIN 


SAMPL189 


0003A8 


000001F800000010 




223 




=A (LISTAREA, 16,LISTEND) 








-^^ 









Figure 17. Assembler sample program 
(Part 6 of 11) 
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IFOSAMP 



SAMPLE PROGRAM 



LOC OBJECT CODE ' ADDR1 ADDR2 STMT SOURCE STATEMENT 



PAGE 7 
ASM 0100 15.00 01/03/72 



0003B0 00000248 

0003B4 0000008000000004 

0003BC 00000080 



224 



=F'128,4,128' 



Figure 17. .Assembler saitple program 
(Part 7 cf 11) 



IFOSAMP 








RELOCATION DICTIONARY 


PAGE 8 


POS.ID 


REL. ID 


FLAGS 


ADDRESS 




ASM 0100 15.00 01/03/72 


0001 


0001 


oc 


000204 






0001 


0001 


oc 


000214 






0001 


0001 


OC 


000224 






0001 


0001 


OC 


0002DC 






0001 


0001 


oc 


00033C 






0001 


0001 


oc 


000354 






0001 


0001 


oc 


000364 






0001 
0001 


0001 
0001 


oc 
oc 


000374 

0003A8 _^ 










0001 


0001 


oc 


0003BJL— — ""^ 







Figure 17. Assembler sample program 
(Part 8 of 11) 



IFOSAMP 














CROSS-REFERENCE 


PAGE 9 


SYMBOL 


LEN 


VALUE 


DEFN 


REFERENCES 






ASM 0100 15.00 01/03/72 


BEGIN 


00004 


00000000 


00057 


00158 


00160 


00176 


00186 00188 00222 




EXIT 


00004 


00000080 


00096 


00113 










HIGHER 


00002 


000000FC 


00132 


00127 










IHB0005 


00001 


00000079 


00091 


00088 










IHB0005A 


00002 


0000007E 


00094 


00087 










IHB0007 


00001 


000000BB 


00108 


00105 










IHB0007A 


00002 


ooooooco 


00111 


00104 










LADDRESS 


00004 


oooooooc 


00213 


00078 










LIST 


00001 


00000000 


00209 


00065 










LISTAREA 


00008 


000001F8 


00158 


00083 


00223 








LISTEND 


00008 


00000248 


00163 


00223 










LISTLOOP 


00004 


00000038 


00080 


00115 










LNAME 


00008 


00000000 


00210 


00126 










LN UMBER 


00003 


00000009 


00212 


00075 










LOOP 


00004 


000000E2 


00125 


00130 


00133 


00159 


00182 00187 




LSWITCH 


00001 


00000008 


00211 


00072 


00114 








MORE 


00004 


00000018 


00066 


00080 










NONE 


00001 


00000080 


00118 


00067 


00114 


00122 


00134 




NOTFOUND 


00004 


00000102 


00134 


00131 










NOTRIGHT 


00004 


00000090 


00104 


00082 


00084 








NOTTHERE 


00004 


000000C6 


00114 


00068 










R0 


00001 


00000000 


00195 












R1 


00001 


00000001 


00196 


00069 


00123 


00124 


00124 00129 00132 




R12 


00001 


oooooooc 


00202 


00061 


00062 








R13 


00001 


0000000D 


00203 


00096 










R14 


00001 


0000000E 


00204 


00066 


00128 


00135 






R15 


00001 


0000000F 


00205 












R2 


00001 


00000002 


00197 


00130 


00133 








R3 


00001 


00000003 


00198 


00123 


00125 


00129 


00132 




R5 


00001 


00000005 


00199 


00064 


00065 


00080 






R6 


00001 


00000006 


00200 


00080 










R7 


00001 


00000007 


00201 


00064 










SAMPLR 


00001 


00000000 


00055 












SAVE 13 


00004 


000000D0 


00116 


00063 


00096 








SEARCH 


00004 


000000D6 


00122 


00066 










SWITCH 


00001 


000000D4 


00117 


00067 


00122 


00134 






TABLAREA 


00008 


00000108 


00140 


00081 


00124 








TABLE 


00001 


00000000 


00217 


00069 










TADDRESS 


00004 


00000004 


00220 


00079 










TESTLIST 


00008 


00000348 


00186 


00083 










TESTTABL 


00003 


00000258 


00168 


00081 










TNAME 
TNUMBER 


00008 
00003 


00000008 
00000000 


00221 
00218 


00126 
00075 














TSWITCH 


00001 


00000003 


00219 


00072 










L-^- 













Figure 17. Assembler sample program 
(Part 9 cf 11) 
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IFOSANP 






LITERAL CROSS-REFERENCE 


PAGE 10 


SYMBOL LEN VALUE 


DEFN 


REFERENCES 




ASM 0100 15-00 01/03/72 


=A (LISTAREA , 1 6 ,LISTEND) 
00004 000003A8 

=F'128,4,128' 

00004 000003B4 


00223 
00224 


00064 
00123 












U — 





r ^, 



Figure 17. Assembler sample program 
(Part 10 of 11) 



IFOSAMP 



ASSEMBLER DIAGNOSTICS AND STATISTICS 



PAGE 



11 



ASM 0100 15.00 01/03/72 



NO STATEMENTS FLAGGED IN THIS ASSEMBLY 

HIGHEST SEVERITY WAS 

OPTIONS FOR THIS ASSEMBLY 

ALIGN, ALOGIC, BUFSIZE (STD) , NODECK, ESD, FLAG (0) , LINECOUNT (55) , LIST, NOMCALL 
NOMLOGIC, NONUMBER, NOOBJECT, NORENT, RLD, NOSTMT, NOLIBMAC, NOTERMINAL, NOTEST, XREF 
SYSPARM () 

WORK FILE BUFFER SIZE = 2558 

TOTAL RECORDS READ FROM SYSTEM INPUT 189 

TOTAL RECORDS READ FROM SYSTEM LIBRARY 833 

TOTAL RECORDS PUNCHED 

TOTAL RECORDS PRINTED 373 



Figure 17. Assembler sample program 
(Part 11 cf 11) 
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Appendix C. Object Deck Output 



ESD CARD FORMAT 



Contents 

12-2-9 punch 
ESE 
Blank 

Variable field count — number cf bytes 
of information in variable field (columns 17-64) 
Elank 

ESDID cf first SD, XD, CM, FC, ER, or WX 
in variable field 
17-64 Variable field. One to three 16-byte 
items of the following format: 



Cc 


lumns 


1 




2- 


4 


5- 


10 


11 


-12 


13 


-14 


15 


-16 



8 bytes — Name, padded with blanks 
1 byte -■ 



ESD 


type 


code 


The 


HEX 


value is 




00 


SD 




01 


LD 




02 


ER 




04 


PC 




05 


CM 




06 


XD (PR) 




0A 


WX 



3 bytes — Address 

1 byte — Alignment if XD; otherwise blank 

3 bytes — Length, LDID, or blank 

65-72 Blank 

73-80 Deck IE and/or sequence number -- 

The deck ID is the name from the first named TITLE 
statement. The name can be cne tc eight alpha- 
meric characters long. If the name is less than 
eight characters long or if there is nc name, the 
remaining columns contain a card sequence number. 
(Coulmns 73-80 of cards produced by PUNCH cr REPRC 
statements do not contain a deck IE or a sequence 
number.) 
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TXT CARD FORMAT 



Columns 



Contents 



1 

2-4 

5 

6-8 

9-10 

11-12 

13-14 
15-16 
17-72 
73-80 



12-2-9 punch 
TXT 
Elank 

Relative address of first instruction on card 
Elank 

Byte count — number of bytes in information 
field (columns 17-72) 
Blank 
ESEIE 

56-byte information field 
Eeck IE and/or sequence number — 
The deck ID is the name from the first named TITLE 
statement. The name can be one tc eight alphameric 
characters long. If the name is less than eight 
characters long or if there is nc naire, the re- 
maining columns contain a card sequence number. 
(Columns 73-80 of cards produced by PENCH or KEPFC 
statements do not contain a deck ID or a sequence 
number . ) 



RLD CARD FORMAT 



Contents 

12-2-9 punch 

RLD 

Elank 

Data field count — number of bytes of 

information in data field (columns 17-72) 

Elank 

Data field 

Relocation ESDID 

Position ESDID 

Flag byte 

Absolute address to be relocated 

Remaining RLD entries 
Deck ID and/or sequence number — 
The deck IE is the name from the first named TITLE 
statement. The name can be one to eight alphameric 
characters long. If the name is less than eight 
characters long or if there is no name, the re- 
maining columns contain a card sequence number. 
(Columns 73-80 of cards produced by PUNCH or REPRO 
statements do not contain a deck ID cr a sequence 
number.) 

If the rightmost bit of the flag byte is set, the following RLD entry 
has the same relocation ESDID and position ESDID, and this information 
will not be repeated; if the rightmost bit of the flag byte is net set, 
the next ELD entry has a different relocation ESDID ard/cr position 
ESDID, and both ESDIDs will be recorded. 

For example, if the RLD Entries 1, 2, and 3 of the program listing 
contain the following information: 



Columns 


1 






2-' 


t\ 




5- 


10 




11- 


-12 




13 


-16 




;> 


-72 






17- 


-18 




19- 


■20 




21 






22- 


■24 




25- 


72 


73- 


-80 





66 



Position Relocation 
ESDID ESDID Flag 



Entry 1 02 
Entry 2 02 
Entry 3 03 



04 
04 
04 



0C 
0C 
0C 



.Address 

000100 
000104 
000800 



Column: 



Entry 1 



17 18 19 20 21 22 23 24 



00 04 00 02 0D 00 01 00 



y 
ESD IDs 



Address 



Flag 
(set) 



Entry 2 



25 26 27 28 



OC 00 01 04 



n ^ 



V— ' 

Address 



Flag 
(not 
set) 



Entry 3 



29 30 31 32 33 34 35 36 



00 01 00 03 0C00 08 00 



y 
EsdIDs 



A 



y 
Address 



Flag 
(not 
set) 



37 —72 



y 
blanks 



END CARE FORMAT 



Columns 



Contents 



1 

2-4 
5 
6-8 

9-14 

15-16 

17-32 

33 

34-43 

44-45 

46-47 

48t49 

50-52 

53-72 
73-80 



12-2-9 punch 

END 

Elank 

Entry address from operand of END card in 

source deck (blank if nc operand) 

Blank 

ESEIE of entry point (blank if nc operand) 

Blank 

1 or 2 

Order number of the assembler: 5741SC103 

Version level of the assembler 

Modification level of the assembler 

Last two digits of the year in which the assembly 

was run 

Eay of the year (counted sequentially: Jan 3=3, 

Feb 3 = 34, etc) in which the assembly was run 

Normally not used 

Eeck IE and/or sequence number. 

The deck ID is the name field from the first named TITLE 

statement. The name can be cne tc eight alphameric 

characters long. If there is no name or the name is less 

than eight characters long, the remaining columns contain 

a card sequence number. (Columns 73-80 of cards produced 

by PUNCH or REPRO statements do net contain a deck ID or 

a sequence number.) 



SYM CARD FORMAT 



If you specify the TEST assembler option, the assembler punches out 
symbolic information concerning the assembled program. This cutput 
appears ahead of the object module. The format of the card images for 
SYM output is as follows: 
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Columns Contents 

1 12-2-9 punch 

2-4 SYM 

5-10 Elank 

11-12 Variable field count — number of bytes of 
text in variable field (columns 17-72) 

13-16 Blank 

17-72 Variable field (see below) 

73-80 Deck ID and/or sequence number — 

The deck IE is the name from the first named TITLE 
statement. The name can be one to eight alphameric 
characters long. If the name is less than eight 
characters long or if there is no name, the re- 
maining columns contain a card sequence number. 
(Columns 73-80 of cards produced by FCNCH or REPFC 
statements do not contain a deck IE or a sequence 
number.) 

The variable field (cclumns 17-72) contains up tc fifty-six bytes of SYtf 
text. The items making up the text are packed together; consequently, 
only the last card may contain less than fifty- six bytes cf text in the 
variable field. The formats of a text card and an individual text item 
are shown in Figure 18. The contents of the fields within an individual 
entry are as follows: 

1. Organization (cne byte) 
Eit 0: 

= non-data type 

1 = data type 

Bits 1-3 (if ncn-data type) : 

000 = space 

001 = control section 

010 = dummy control section 

011 = common 

100 = machine instruction 

101 = CCW 

110 = Simply relocatable EQU, named LTORG, named CKCF, 
or named ORG 

Eit 1 (if data type) : 

= no multiplicity 

1 = multiplicity (indicates presence of M field) 

Eit 2 (if data type) : 

= independent (not a packed cr zcned decimal constant) 

1 = cluster (packed cr zcned decimal constant) 

Bit 3 (if data type) : 

= no scaling 



Eit U: 



Eits 5-7 



1 = scaling (indicates presence of S field) 



= name present 

1 = name not present 



Length of name minus 1 

2. Address (three bytes) — - displacement frcm base cf ccntrcl section 

3. Symbol Name (zero to eight bytes) — symbolic name of particular 
item 



68 



Note: The follwing fields are present cnly for data-type items. 

4. Eata Type (one byte) — contents in hexadecimal 

00 = C-type data 

04 = X-type data 

08 = B^-type data 

10 = F-type data 

14 = H-type data 

18 = E-type data 

1C = D-type data 

20 = A-type or Q-type data 

24 = Y-type data 

28 = S-type data 

2C = V-type data 

30 = P-type data 

34 = Z-type data 

38 = L-type data 

5. Length (two bytes for character, hexadecimal , or binary items; 
one byte for other types) — length of data item irinus 1 

6. Multiplicity - M field (three bytes) — equals 1 if not present 

7. Scale - signed integer - S field (two bytes) — present only for 
F, H, E, E, L, p and Z type data, and cnly if scale is ncn-zero. 



1 


2 4 


5 10 


11 1213 16 


17 






72 


73 8( 








No. 














12 
2 
9 


SYM 


blank 


of 
bytes 

of 
text 


blank 




SYM text - 


- packed entries 




Deck Sequence 
ID number 




N complete entries 
N> 1 



Variable size entries 



Org. 



Address 



Symbol name 



Data 
type 



Length 




13 0-8 

Figure 18. SYM Card Format 



1-2 
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Appendix D. Dynamic Invocation of the Assembler 



You can invoke the assembler from your problem program when it is 
executed, by using the CALL, LINK, XCTL, or ATTACH iracrc instruction. 
If you use the XCTL instruction, you cannot specify any assembler 
options. The assembler will use the standard or default options. If 
you use CALL, LINK, or ATTACH, you can specify both the assembler 
options and CE names of the data sets to be used by the assembler. The 
formats of these macros are: 



Name 


Operation 


Operand 


[symbol] 


CALL 

/ LINK \ 
\ ATTACH j 


IFOXOO, (option list 

[,ddnamelist]),VL 

EP=IFOX00, 

PARAM={optionlist 

[,ddnamelist]),VL=1 



EP -- specifies the symbolic name of the assembler (IFOXOO) . 

FAFAtf -- specifies, as a sublist, address parameters tc be passed from 
the problem program to the assembler. The first word in the 
address parameter list contains the address of the option list. 
The second word contains the address of the ddname list. 

optionlist — specifies the address of a variable length list containing 
the options. This address must be written even if nc option 
list is provided. 

The option list must begin on a half word boundary. The first two bytes 
contain a count of the number of bytes in the remainder of the list. If 
no options are specified, the count must be zero. The option list is 
free form with each field separated from the next by a comma. No blanks 
or zeros should appear in the list. 

ddnamelist — specifies the address of a variable length list containing 
alternate EEnarces for the data sets used during assembler 
processing. If standard DBnames are used, this operand can be 
omitted. 

The EDname list must begin on a half word boundary. The first two bytes 
contain a count of the number of bytes in the remainder of the list. 
Each name of less than eight bytes must be left-justified and padded 
with blanks. If an alternate EEname is emitted, the standard name will 
be assumed. If the name is omitted within the list, the eight-byte 
entry must contain binary zeros. Names can be emitted frcm the end 
merely by shortening the list. The sequence of the eight-byte entries 
in the EEname list is as follows: 
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Entry Standard Name 



1 


not applicable 


2 


not applicable 


3 


not applicable 


4 


SYSLIE 


5 


SYS IN 


6 


SYSPRINT 


7 


SYSPUNCH 


8 


SYSUT1 


9 


SYSUT2 


10 


SYSUT3 


11 


SYSGO 


12 


SYSTERM 



VL — specifies that the high-order bit is to be set tc 1 in the last 

word of the list of address parameters in the macro expansion. 
The assembler checks this bit to find out if a DDname list is 
specified or not. 

Note : If you invoke the assembler more than once from the same program, 
make sure that RECFM=S is not specified for the SYSPRINT data set. 
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Appendix E. Assembler Data Sets and Storage 
Requirements 



This appendix describes the data sets used by the asseirbler (see Figure 
19) . It also describes the main storage and auxiliary storage 
requirements of the assembler. This description is intended fcr 
programmers who want tc alter the assembler's region or partition size 
or data set parameters (such as buffer size) . A mere detailed 
description of assembler storage requirements appears in CS/VS1 Storage 
Estimates , Crder No. GC28-0604. 



ASSEMBLER DATA SETS 



DDname SYSUT1, SYSUT2 , and SYSUT3 



The assembler uses the utility data sets as intermediate external 
storage devices when processing the source program. These data sets must 
be organized sequentially, and the devices assigned to them must be 
direct access devices, magnetic tape units, or a combination of both. 
The assembler does not support multivolume utility data sets. For 
optimum performance, SYSUTl should be on a direct access device. 

CDname SYSIK 

This data set contains the input to the assembler — the source 
statements tc be processed. The input/output device assigned to this 
data set may be either the device transmitting the input stream, cr 
another sequential input device that you have designated. The ED 
statement describing this data set appears in the input stream. The 
IBK-supplied procedures do not contain this stateirent. 

CDname SYSLIE 

From this data set the assembler obtains macro definitions and assembler 
language statements that can be called by the COPY assembler 
instruction. It is a partitioned data set: each iracrc definition cr 
sequence of assembler language statements is a separate member, with the 
member name being the macro instruction irnemcnic cr CCF'X cede name. 

The data set may be SYS1.KACLIB or a private macro library. 
SYS1.KACLIE contains macro definitions fcr the IEtf- supplied macro 
instructions. Private libraries and SYS1.MACLIB can he concatenated 
with each other in any crder. Concatenated libraries must have the same 
record length, but the blocking factors may be different. However, a 
library with a high blocking factor must always come before a library 
with a low blocking factor. 

DDname SYSPPINT 

This data set is used by the assembler tc produce a listing. Cutput may 
be directed tc a printer, magnetic tape, or direct-access storage 
device. The assembler uses the ASCII carriage-ccntrcl characters fcr 
this data set. The smallest blocksize recommended is 1089 (blocking 
factor of 9) . 
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DDname SYSPUNCH 

The assembler uses this data set to produce the object module. The 
input/output unit assigned to this data set may be either a card punch 
or an intermediate storage device capable cf sequential access. This 
output can be used as input to the linkage editor. 

DDname S YSGO 

This is a direct-^access storage device or magnetic tape data set used by 
the assembler. It contains the same output text (object ircdule) as 
SYSPUNCH. It is used as input for the linkage editor. 

DDname SYSTERM 

This data set is used by the assembler to produce diagnostic 
information. The output may be directed to a remote terminal, a printer, 
a magnetic tape, or a direct-access storage device. The assembler uses 
the ASCII carriage control characters for this data set. The smallest 
blockzise recommended is 1089 (blocking factcr cf 9) . 



ASSEMBLER VIRTUAL STORAGE REQUIREMENTS 



The minimum virtual stcrage partition or region required by the 
assembler is 64K bytes. However, better performance is generally 
achieved if the assembler is run in 128K bytes of virtual storage. This 
region size is recommended and is specified in the assembler cataloged 
procedures. 

If more storage is allocated to the assembler, the size cf buffers and 
work space can be increased. The amount cf stcrage allocated to buffers 
and work space determines assembler speed and capacity. Generally, as 
more storage is allocated to buffers, a given assembly will run faster; 
as more storage is allocated to work space, larger and mere complex 
macro definitions can be handled. 

You can control the buffer sizes of SYSIN, SYSLIB, SYSPRINT, 
SYSPUNCH, and SYSGO by specifying the blocksize (ELKSIZE) and number of 
buffers (EUFNC) as shown in Figure 19. 

You can control the buffer sizes for the assembler utility data sets 
(SYSUT1, SYSUT2, and SYSUT3) and the size of the work space used during 
macro processing, by specifying the BUFSIZE assembler cpticn. Of the 
storage given to the assembler, the assembler first allocates storage 
for the SYSIN and SYSLIE tuffers according to the specifications in the 
DD statements or the labels of the data sets. It then allocates storage 
for the modules of the assembler. The remainder cf the partition or 
region is allocated tc utility data set buffers and macro generation 
dictionaries according to the EUFSIZE cpticn specified: 

BUFSIZE (STD) : 37% is allocated to buffers, and 63% to work space. 

This is the default chosen, if ycu dc net specify any 
EUFSIZE option. 

BUFSIZE (WIN) : Each utility data set is allocated a single 790-byte 
buffer. The remaining storage is allocated to work 
space. This allows relatively complex macro 
definitions to be processed in a given region or 
partition size, fcut the speed cf the assembly is 
substantially reduced. 
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•Q0 



i 



/ SYSPRINT \ / SYSGO ^ / SYSPUNCH ^ 





LQ 





SYSIN 


SYSLIB 


SYSPRINT 
SYSTERM 


SYSPUNCH 


SYSGO 


SYSUT1 
SYSUT2 
SYSUT3 


LRECL 


Fixed at 80 


Fixed at 80 


Fixed at 121 


Fixed at 80 


Fixed at 80 


N/A 


RECFM 

© 


You must specify 
in LABEL or DD 
card 

F,FS,FBS,FB, 
FBST, FBT 


You must specify 
in LABEL or DD 
card 

F,FS,FBS,FB, 
FBST.FBT 


F and A set by 
assembler. B set 
by assembler 
except when F is 
specified and 
BLKSIZE is not 
specified. You 
may add S or T 
FA,FAB,FAS,FAT 
FABS.FABT 


F set by assembler, 
you may specify B 
and/or T in label 
or DD card 

F.FB.FT, 
FBT 


F set by assembler, 
you may specify B 
and/or T in label 
or DD card 

F.FB.FT, 
FBT 


Set by assembler 
toU 


BLKSIZE 

© 


You must specify 
in LABEL or DD 
card, must be a 
multiple of 
LRECL 


You must specify 
in LABEL or DD 
card, must be a 
multiple of 
LRECL 


Optional, but must 
be a multiple of 
LRECL; if omitted 
BLKSIZE=LRECL 


Optional, but must 
be a multiple of 
LRECL; if omitted 
BLKSIZE=LRECL 


Optional, but must 
be a multiple 
LRECL; if omitted 
BLKSIZE=LRECL 


If BUFSIZE (STD) 
in effect, a value 
between 790 and 
8192 is chosen. 
If BUFSIZE (MIN) 
in effect, 790 is 
chosen 


BUFNO 


Optional; if 
omitted 2 is used 


Set by assembler 
to 1 


Optional; if 
omitted 2 is used 


Optional; if 
omitted 3 is used 
for unit record and 
2 for other devices 


Optional; if 
omitted 3 is used 
for unit record and 
2 for other devices 


Set by assembler 
to either 1 or 2 



r 



MJ U = undefined, F = fixed length records, B= blocked records, S= standard blocks, 
T = track overflow, A = ASCI I code carriage control 

(2) Blocking is not allowed on unit record devices. Blocking on other direct access can not 
be greater than the track size unless T is specified on RECFM. If the BLKSIZE specified 
is not a multiple of LRECL, the assembler truncates it to a multiple. For example, if 
LRECL = 80, a BLKSIZE of 850 is truncated to 800. 



Figure 19. Assembler data set characteristics 
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Appendix F. The SYSTERM Listing 



The SYSTERM data set, which gives you rapid access to the diagnostic 
messages issued during an assembly, is primarily designed fcr the user 
of the Time Sharing Option (TSO) of VS2. However, the data set can also 
be directed to a printer, a magnetic tape, or a direct-access device. 

You use the assembler option TERMINAL to specify that you want a SYSTERM 
listing to be produced. Of course, you must also make sure that a BE 
statement describing the data set is included. 

Each diagnosed statement in the assembly listing printed in the SYSTERM 
listing immediately followed by the messages that are issued for the 
statement. To help identify the position of the stateirent in your 
program, two additional assembler options are available: 

• NUMBER, which prints the line number (s) of the diagnosed statement. 

• STMT, which prints the statement number assigned to the diagnosed 
statement by the assembler. 

The format cf the flagged statement as it appears in the listing is: 



Line No.(s) 
(option NUM) 



Statement No. 
(option STMT) 



Source record(s) 
(Columns 1-72 of 
the source 
statement lines) 



If a statement contains continuation lines, it will occupy several lines 
in the listing, each identified by a line nuirber (if cpticn NUMBER is 
used) . If a statement in error is discovered during the expansion of a 
macro, or of any inner macro called by an cuter macro, the first line of 
the outer macro instruction is listed before the flagged statement. If 
a statement is flagged during variable symbol substitution in open code, 
the first line of the model statement is listed as well as the generated 
statement. 

Figures 20 and 21 illustrate the content and format of SYSTERM output. 
Figure 20 shows the source statement section cf a SYSFRINT listing, and 
Figure 21 shews the SYSTERM listing produced during the same assembly. 
The example illustrates the rules given above. Options TERMINAI, 
NUMBER, and STMT were in effect during the assembly. 

The SYSTERM listing starts with the statement ASSEMBLER DONE. At the 
end of the listing the following diagnostic information is given: 

• NUMEER CF STATEMENTS FLAGGED IN THIS ASSEMBLY = nn 

(Indicates the total number of source statements in error) 

• HIGHEST SEVERITY CODE WAS nn 

(Indicates the maximum severity code encountered) 

• OPTIONS FOR THIS ASSEKELY 

(Indicates the options in effect fcr this assembly) 



Appendix F. The SYSTERM Listing 75 





















PAGE 2 


LOC 


OBJECT CODE 


ADDR1 


ADDR2 


STMT 


SOURCE 


STATEMENT 




ASM 0100 14.59 01/03/72 










1 




MACRO 
















2 




GENF 


tP,(L 














3 




LCLA 


tK 














4 


-LOOP 


ANOP 
















5 


tK 


SETA 


tK*1 














6 


tFtL (tK) 


DC 


F'tL(fK) « 














7 




AIF 


(tK LT N' 


tL) 


.LOOP 










8 


.DOME 


MEND 
















9 




GBLC 


*Q 






000000 








10 
11 


SAMPL2 


CSECT 
SAVE 


(14,12) 




ALL REGS ARE SAVED IN SUPERVISOR SAVEAREA 


000000 








124 




DS 


OH 




00660000 


000000 


90EC DOOC 


0000C 




13 + 


STM 


14,12,12(13) 


SAVE REGISTERS 01180000 


000004 


05C0 






14 




BALR 


R12,0 












00006 


15 
16 


«Q 


USING 
SETC 


♦ ,R12 
•B' 




SET UP BASE REGISTER 


000006 


0000 0000 
♦** ERROR 


00000 
*** 




17 




L 


R2,END 




END OF AREA 


00000A 


0000 0000 
♦** ERROR 


00000 
*** 




18 




LA 


R3,A 




THIS IS A » 
DUMMY COMMENT * 
TO SHOW * 

A STATEMENT CONTAINING ♦ 
TOO MANY CONTINUATION CARDS 


00OOOE 


5840 C022 


00028 




19 




L 


R4,F0 




ZERO CONSTANT FOR RESETTING AREA 


000012 


5043 0000 


00000 




20 


LOOP 


ST 


R4,0 (R3) 






000016 


4130 3004 


00004 




21 




LA 


R3,4 (,R3) 




RESET AREA A 


00001A 


1923 






22 




CR 


R2,R3 






00001C 


4770 COOC 


00012 




23 




BNE 


LOOP 














24 




AIF 


('A' EQ ■ 


tQ' 


-GO 










25 




SR 


tQ,tQ 




OPEN CODE MODEL STATEMENT ♦ 
WITH CONTINUATION CARD 


000020 


0000 

♦♦* ERROR 


*♦* 




26i 

4 




SR 


B,B 




OPEN CODE MODEL STATEMENT ♦ 
WITH CONTINUATION CARD 










27 


.60 


RETURN (14,12) 




EXIT FROM RTN 


000022 


98EC DOOC 


0000C 




284 




LM 


14,12,12 


(13) 


RESTORE THE REGISTERS 00260000 


000026 


07FE 






294 
30 


• 


BR 


14 




RETURN 00800000 










31 


♦ CONSTANTS AND AREA ARE DELETED ON PURPOSE 










32 


• 


















33 




GENF 


F,0 




GENERATION OF CONSTANTS 


000028 


00000000 






34*F0 


DC 


F'O* 














35 




GENF 


1,234 




EXAMPLE OF MORE THAN ONE CARD * 
IN A MACRO INSTRUCTION 


00002C 


OOOOOOEA 
*** ERROR 


**# 




364 


1234 


DC 


F'234' 












00002 


37 


R2 


EQU 


2 













00003 


38 


R3 


EQU 


3 




>^^ 








00004 


39 


R4 


EQU 


4 




^ — 








OOOOC 


40 
41 


R12 


EQU 
END 


12 









***" 











Figure 20. SYSPRINT listing of the source statements used to show 
SYSTERM output 
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ASSEMBLER (XF) DONE 

17 L R2,END 
IF0188 END IS AN UNDEFINED SYMBOL 

18 LA R3,A 



END OF AREA 

THIS IS A 
DUMMY COMMENT 
TO SHOW 



IF0188 
IFO069 



A IS AN UNDEFINED SYMBOL 

EXCESSIVE CONTINUATION CARDS, TWO ALLOWED 



25 



26+ 



SR 



SR 



SQ,SQ 
B,B 



IF0188 B IS AN UNDEFINED SYMBOL 

IF0188 B IS AN UNDEFINED SYMBOL 

35 GENF 

36+1234 DC 



A STATEMENT CONTAINING 
TOO MANY CONTINUATION CARDS 
OPEN CODE MODEL STATEMENT 
WITH CONTINUATION CARD 
OPEN CODE MODEL STATEMENT 
WITH CONTINUATION CARD 



EXAMPLE OF MORE THAN ONE CARD 



1,234 
F'234' 

IF0125 INVALID NAME- ILLEGAL EMBEDDED CHARACTER OR NON-ALPHABETIC FIRST CHARACTER 
NUMBER OF STATEMENTS FLAGGED IN THIS ASSEMBLY = 4 
HIGHEST SEVERITY WAS 8 
OPTIONS FOR THIS ASSEMBLY 

ALIGN, ALOGIC, BUFSIZE (STD) , NODECK, ESD, FLAG (0) , LINECOUNT (55) , LIST, NOMCALL 
NOMLOGIC, NUMBER, NOOBJECT, NORENT, RLD, STMT, NOLIBMAC, TERMINAL, NOTEST, XREF 
SYSPARM () 




Figure 21. SYSTERM listing produced for the source statements shown in 
Figure 20. 
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Appendix G. Assembler Diagnostic Error Messages 



r 

This appendix lists all the diagnostic messages issued by the VS v 

Assembler. The messages are listed sequentially by statement number. 



HOW TO USE THIS SECTION 

Once ycu have found an error message in the diagnostics section of 
your listing that you are not sure you understand fully, look up the 
entry for the message in this appendix. The entry fcr the message will 
give you the following items: 

The message number and the text of the message. 

Explanation of the message. 

Assembler action in response to the message. 

Programmer response to correct the error. 

Operator response to correct the error (only for certain messages) . 

Severity code assigned to the message. 

The following paragraphs describe the messages as they appear in your 
listing and explain in detail the various items of each entry in this 
appendix. 



The Message Itself 

In the diagnostics section of your assembler listing ycu will find 
the following items fcr each message: 

• The number of the statement in error. 

• The message identification number. 

• The text of the message. 

STATEMENT NUMBER: For certain messages the statement number given is 
always 0, either because the assembler cannot identify the number of the 
statement in which the error occurs when it finds the error, or because 
the error cannot be associated with a specific statement. For some of 
these messages, the text of the message identifies the macro in which the 
error is found. 

Fcr errcrs found during the editing of a library iracrc, the 
statement number given is that of the last numbered statement in the 
source module, unless the LIEMAC and MLOGIC assembler cpticns are in 
effect, as described below under "Explanation". 

MESSAGE NUMBER: The message identification number is a unique number 
consisting of the letters IFO followed by a three digit number. 

TEXT: The text of the message is not always printed out in full in the 
diagnostics section of the listing. However, the corresponding text in 
this appendix is always fully printed out. 

Certain messages include information in the. message text to help you 
localize the error within the statement. In the message text as it 
appears in this section, 'nn' denotes a nuirber and 'xxxxxxxx* a 
character string. The number identifies a column in the operand of the 
statement in error that is close to the ccluirn where the error is found. 
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The character string may represent a syirtcl cr the wcrd MACRO. It is 
limited tc eight characters, so if the string containing the error is 
longer, it is truncated. 



Explanation 

This iteir gives the probable cause or causes of the error message. 
An error message is issued at the point where the assembler can no 
longer make sense cf the text, not necessarily at the point where the 
real error occurred. For example, if you want to code the 
instruction LR 3,5, and leave out the R in the operation cede, the 
assembler will treat the instruction as a stcrage-tc- register 
instruction, and give an error message for the second operand (unless 
NOALIGN is specified) . 

If errors occur during the editing or expansion of a library macro 
and the assembler options specified cause the legic cf the macro 
expansions not tc be printed, error messages for the library macro will 
be logged against the last numbered statement in the program. However, 
if you use the LIEMAC and MLOGIC assembler options, errors in library 
macros will be logged against the statements in error. See the section 
"Assembler Options" for a discussion of these options. 



Assembler Act i on 

This item tells ycu hew the assembler reacts to the error. A 
machine instruction usually causes zeros to be generated in its place in 
the cbject ircdule if a major error occurs anywhere in that instruction. 
An assembler instruction is usually printed out but not processed 
("processed as a comment") . Some machine and assembler instructions, 
however, are partially processed or processed with a default value. In 
some cases the assembler terminates the whole assembly. 



Programmer Re sponse 

This item tells ycu hew to correct the statement in error. It is 
assumed that you will detect certain errors when an error message draws 
your attention tc the statement. Thus, the programmer response for each 
message dees not tell ycu to check for keypunching errors or to check 
the use of the flagged statement. 



Operator Response 

This item tells the operator how to correct certain errors. The 
operator response is enly given for messages that are printed en the 
operator's console. The operator will not change your source deck. He 
may, however, do such things as change partition cr region size, cr 
correct certain jcb ccntrcl errors. 
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Severity Code 



The severity code indicates the seriousness of the errcr. The 
severity cedes used by the VS Assembler and their Hearings are shewn in 
the following table. 



Severity 
Code 



12 



16 



20 



V J 



Explanation 



Minor error; successful program execution is 
probable 

Significant error; unsuccessful program 
execution is possible 

Serious error; unsuccessful program execution 
is probable 

Critical error; normal execution is 
impossible 

Critical error; further assembly impossible, 
assembly terminated 



The severity cede is the return code issued by the assembler when it 
returns control to the operating system. The IBM- supplied cataloged 
procedures include a CCND parameter on the linkage edit and execution 
steps. The CCNE parameter prevents execution of these steps if the 
return code from the assembler is greater than 8. 



RECURRING ERRORS 



If an errcr message recurs after the error situation has been 
corrected and there seems to be nothing wrong with the statement, there 
may be an error in the assembler. If ycu suspect that this is the case, 
make sure the program is correct and reassemble if necessary. If the 
problem still persists, dc the following before calling IEM: 

• Have your source program, macro definitions, and associated listings 
available. 

• If a COPY statement was used, execute the IEBFTPCH utility tc obtain 
a copy cf the partitioned data set member specified in the COPY 
statement . 

• Make sure that MSGIEVEL= (1 , 1) was specified in the JCE statement. 
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IFOOOO UNDEFINED ERROR CODE IFCxxx 

Explanation : An error code has teen generated by the assembler 
for which nc message has teen defined. This is caused by a 
logical errcr in the assembler. 

Assembler .Action : Assembly continues. 

Programmer Response : Perform the actions described under 
"Recurring Errors" above before calling IBM. 

Severity Cede: 16 



IFO0 01 SYSTEM VARIABLE SYMBOL xxxxxxxx USED AS SYMECLIC PARAMETER IN 
MACRO PROTOTYPE 

Explanation : A variable symbol used as a symbolic parameter on 
a macro prototype statement has the same characters as a system 
variable symbol. The system variable symbols are: 



SSYSECT 

SSYSLIST 

SSYSNDX 



SSYSPARM 
6SYSTIME 
SSYSDATE 



Assembler Action : Editing of the macro definition is terminated. 
All statements in the macro definition are processed as 
comments . 



Programmer Response : Redefine the parameter with a variable 
symbol other than SSYSPARM, SSYSDATE, SSYSTIME, SSYSLIST, 
SSYSECT, or SSYSNEX. 

Severity Co d e : 8 



IFO002 SYMECLIC PARAMETER xxxxxxxx IS DUPLICATED IN SAME MACRO 
PROTOTYPE 

Explanation : Two identical symbolic parameters have been 
specified in the same macro prototype statement. 

Assembler Action: Editing of the macro definition is terminated 
All statements in the macro definition are processed as 
comments . 

Prog ramm er Response : Redefine one of the symbolic parameters 
with a variable symbol that is unique to that particular macro 
definition. 

Severity Cede : 8 



IFO003 SYSTEM VARIAELE SYMEOL xxxxxxxx USED IN OPERAND OF GLOEAL OR 
LOCAL DECLARATION 

Explanation: A system variable symbol has been used in the 
operand of a global or local declaration. The system variable 



symbols are: 
SSYSECT 



SSYSPARM 
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6SYSLIST 
SSYSNDX 



SSYSTIME 
SSYSDATE 



Assembler Act ion : The declaration conflicting with the system 
variable symbol is ignored. All subsequent references to the 
variable symbol in error are treated as references to the 
system variable symbol. 

Programmer Response : Redefine the variable symbol using 
character combinations other than those listed abcve in the 
explanation. 

Severity Code : 8 



IFO004 GLOBAL OR LOCAL VARIABLE xxxxxxxx DUPLICATES A SXMECLIC 
PARAMETER IN SAME MACRO DEFINITION 

Explanation : A variable symbol that appears in the operand 
field of a global or local declaration is identical tc a 
symbolic parameter defined on the macro prototype earlier in 
the macro definition. 

Assembler Action : The declaration conflicting with the symbolic 
parameter is ignored. All subsequent references to it are 

treated as references to the symbolic parameter that it 
duplicates. 

Programmer Response : Redefine the global or lccal variable with 
a variable symbol that is unique to the macro definition. 



Severity Cede: 
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IF0005 GLCEAL OR LOCAL VARIAELE SYMBOL xxxxxxxx DUPLICATES PREVIOUS 
DECLARATION 

Explanation : A global or local variable symbel was declared 
twice in the same macro definition or in open cede. 

Assemble r Action : The second declaration of the variable symbol 
is ignored. All subsequent references to it are treated as 
references to the first declaration. 

Prog rammer Response : If the second declaration is LCIx, 
redeclare it using a variable symbol unique to the macro 
definition or to open code. If the second declaration is GBLx, 
redeclare it as for LCLx, but be sure that all declarations of 
that global variable elsewhere in the program are identical. 

Severity Cede : 8 



IFO006 



UNDEFINED VARIAELE SYMBOL xxxxxxxx 
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Expl anation: A variable symbol has been referenced in this 
statement that is not a system variable symbol; has not been 
defined within the macro definition as a symbolic parameter, a 
local variable, or a global variable; or has net been defined 
in open cede as a local or global variable. 



Asse mbler Action ; The statement is processed as a comment, 
unless the error has occurred in a macro instruction parameter. 
If the macro instruction parameter contains an undefined 
variable symbol, the parameter is assigned the value of a null 
string. 

Programmer Response : Define the variable symbol as a symbolic 
parameter, a local variable, or a global variable; or, if 
desired, reference a previously-defined variable symbol of the 
appropriate type. This message may be issued if an ampersand 
erroneously appears as the first character of an ordinary 
symbol, and thus creates an unintended variable symbol. 

Severity Code : 8 



IFO007 USAGE OF xxxxxxxx IS INCONSISTENT WITH ITS DECLARATION 

Explanation: A global or local variable symbol was defined as 
dimensioned but was used without a subscript, or a global or 
local variable symbol was defined as undimensicned but was used 
with a subscript. 

Assembler Action : Editing of the statement that contains the 
inconsistent usage is terminated, and the statement is processed 
as a comment. 

Programmer Response : Make the usage of the SET symbol 
consistent with its global or local declaration, or make the 
declaration of the SET symbol consistent with its usage. 

Severity Code : 8 



IFO0 08 CIRCULAR OPSYN STATEMENTS 

Explanation : The assignment of a synonym in the operand field 
of an OPSYN statement to the established mneircnic in the name 
field results in the mnemonic being its own synonym, for 
example: 



ADD 


OPSYN 


A 


PLUS 




OPSYN ADD 


XYZ 


OPSYN 


PLUS 


ADD 


OPSYN 


XYZ 



The final OPSYN statement in the above sequence is flagged. 

Assembler Action : The flagged OPSYN statement is processed as a 
comment. 

Programmer Response : Remove any OPSYN statement that results in 
a circular definition, or alter such an OPSYN statement by 
respecifying the synonym or the mnemonic. 

Severity Code : 8 
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IFO009 EEIT DICTIONARY SPACE EXHAUSTED 

Expl anation; The work space available is not sufficient to 
contain the dictionaries that are required to edit the macro 
definition or open code. 

Assembler Action; If a macro definition is being edited, the 
remaining statements up to the WEND statement are processed as 
comments, and editing resumes. If open cede is being edited, 
the remaining statements up to the end-of-file are processed as 
comments . 

Pro grammer Response ; Increase the size of the region or 
partition that is allocated to assembly, or allocate more 
dictionary space via the EUFSIZE assembler cpticn. See Appendix 
E cf this manual. 

Severity Code ; 12 



IFO010 SOURCE MACRO xxxxxxxx HAS BEEN PREVIOUSLY DEFINED 

Explanation; The mnemonic in the macro instruction prototype of 
a source macro duplicates a mnemonic already defined as a 
source macro. 

Assembler Action ; All statements in this macro definition are 
processed as^comments. All subsequent references to the 
mnemonic are treated as references to the first definition 
associated with that op cede. 

Programmer Response ; Provide a unique mnemonic cp cede fcr the 
flagged macro prototype. 

Severity Cede ; 8 

IF0012 ICTL OR OPSYN STATEMENT APPEARS TOO LATE IN THE PROGRAM 
Explanation ; 

• The ICTL statement does net precede all ether statements in 
the source module; or 

• The OPSYN statement does not appear before source macro 
definitions and open code statements. The enly statements 
that can precede an OPSYN statement are: ICTL, ISEQ, TITLE, 
PRINT, EJECT, SPACE, OPSYN, COPY (unless the member copied 
contains any other than the statements listed here) , and 
comments statements. 

Assembler Acticn ; The ICTL or OPSYN statement is processed as a 
corrment. 

Programmer Response : Place the ICTL or OPSYN statement at the 
beginning of your program as described in the explanation above. 

Severity Code : 8 



84 



IFO013 CPSYN NAME FIELD NOT ORDINARY SYMEOL, OR OPSYN OPERAND FIELD 
NOT ORDINARY SYMEOL OR ELANK 

Explanation; The name or operand field of an OPSYN instruction 
contains more than 8 alphanumeric characters or does not begin 
with an alphabetic character. 

Assemble r Action ; The CFS^N statement is processed as a comment, 

Prog r ammer Response ; Correct the invalid name field or operand 
field. 

Severity Cede; 8 



IFO014 INVALID OPCODE IN OPSYN OPERAND OR NAME FIELE 
Explanation ; 

• The name field of an OPSYN instruction with a blank operand 
field dees not specify a machine instruction operation code, 
an extended machine instruction operation cede, cr an 
assembler operation code; cr 

• The operand field of an OFSYN instruction does not specify 
a machine instruction operation code, an extended machine 
instruction operation code, cr an assembler operation code. 

Asse mble r Action ; The CPSYN statement is treated a comment. 

Prog ra mmer Response ; Make sure that the name field contains a 
valicPoperation code, or supply a valid operation code in the 
operand. 

Severity Cede : 8 



IFO016 ILLEGAL OR INVALID NAME FIELD 

Explanation ; One of the following errors was detected. 

• No name was found where one is required. 

• A name was supplied where none is allowed. 

• An invalid character was found in the narre field. 

Assembler Act ion ; The statement is processed as a ccmirent, 
unless the error has occurred in the name field of a macro 
instruction. If the macro naire field parameter contains an 
error, the parameter is assigned the value of a null string. 

Programmer Re sponse ; Supply a name if one is required, omit the 
name if one is not allowed, or correct the invalid character. 

Severity Code : 8 
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IFO017 . * COMMENTS STATEMENT IS ILLEGAL OUTSIDE MACRO DEFINITION 

Explanation: P.n internal macro coirirents statement (.*) appears 
outside macro definitions (in open code) . 

Assem bler Action ; The statement is printed. 

Prcg r ammer Response ; Remove the . * comments statement. If you 
want^a comment , put an * in the begin column and follow it by 
the comment. 

Severity Cede ; 4 



IF0018 MORE THAN 5 ERRORS IN THIS STATEMENT, ERROR ANALYS OF THE 
STATEMENT IS TERMINATED 

Explanation : The maximum number cf errcr messages issued during 
editing tc each statement is 5. The sixth errcr causes this 
iressage. 

Assembler Action : Error analysis for this statement is 
terminated. 

Programmer R esponse : Correct the indicated errors and 
reassemble. Any additional errors on this statement will be 
detected in the next assembly. 

Seve r ity Cede : 4 



IF0019 INVALID OPERAND IN ICTL OR ISEQ STATEMENT 
Explanation : 

(1) The value of one or more operands in an ICTL statement is 
incorrect. The begin column must be within columns 1 to 40; 
the end column must be within columns 41 tc 80 and at least 5 
columns away from the begin column; and the continue column 
must be within columns 2 to 40. 

(2) Cne cf the following errors has occurred in an ISEQ 
statement: 

• The operand has an illegal range; the operand value 
cannot fall between the begin and end columns, and the 
second operand must net be less than the first. 

• The operand field is invalid. The operand field must 
contain two valid decimal self-def inirg terirs, 
separated by a comma or be blank. 

Assembler Action : If a program contains an ICIL error, the 
whole prcgrair is processed as coirirents. If ere cf the ISEQ 
errors has occurred, no sequence checking is performed. 

Programmer Response : Supply valid operand (s) . 

Seve rity Cede : 8 
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IFO021 INVALID TERM IN OPERAND 

Explanation ; An invalid term has been used in an expression of 
the operand. 

Assembler Action : The statement is processed as a comment. 

Programmer Response ; Make sure the operand is a character 
relation, an arithmetic relation, a logical relation, a SETx 
symbol, a symbolic parameter, or a decimal self -defining term. 

Severity Cod e; 8 



IFO022 ICTL STATEMENT IS ILLEGAL IN COPY CODE 

Expl anation: An ICTL statement appears in code that is inserted 
in t^e program by a COPY instruction. 

Assembler Action ; The ICTL statement is processed as a comment. 

Programmer Response ; Make sure the ICTL instruction is net in 

code inserted by the COPY instruction. If used, the ICTL 

instruction must always be the first instruction in your source 
module. 

8 



IFO023 ILLEGAL MACRO, MENE, OR MEXIT STATEMENT - MAY AFFEAR ONLY VvITHIK 
MACRO DEFINITIONS 

E xpl anation: MACRO, MENE, or MEXIT statements are net allowed 
in open code. They can be used only in macro definitions. 
This message will be issued if an instruction ether than ICTL, 
ISEQ, OPSYN, TITLE, PRINT, EJECT, SFACE, or COPY appears before 
any macro definitions in your program. Of course, any such COPY 
instruction cannot copy any other statements than ISEQ, CPSYK, 
TITLE, PRINT, EJECT, or SPACE. This message will also be 
issued, if an undefined operation code appears before your 
macro definitions. 

Assembler Action : The illegal MACRO, MEND, cr MEXIT statement 
is processed as a comment. 

Pro grammer Re sponse : Remove the statement from open code on 
place it within a macro definition. Make sure that all your 
macro definitions are placed at the beginning, before open code. 

Sever ity Cede : 8 



IFC024 UNPAIRED PARENS, OR BLANK FOUND INSIDE PAIRED PARENS 
Explanation; 

• Unpaired parentheses appear in the operand field; or 

• A blank appears inside paired parentheses in the operand 
field of a macro instruction. This may be an error in 
sublist structure; or 
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• A blank appears inside parentheses cf an arithmetic 
expression; cr 

• A term is missing in a logical expression. 

Assembler Action ; The operand in error is igr.cred. 

Programme r R e sponse ; If unpaired parentheses appear, be sure 
that there is a right parenthesis for every left parenthesis, 
Remove illegal blanks inside paired parentheses. 

Severity Cede ; 8 



IFO025 STATEMENT OUT OF SEQUENCE 

Explanation : The input sequence checking specified by the ISEQ 
instruction has determined that the flagged statement id out of 
sequence . 

Assembler Action : The statement is flagged and assembled, 
however , the sequence number of the following statements will te 
checked relative to this statement and net relative tc the 
sequence cf previous statements. 

Programmer Response ; Put the statement in the proper sequence. 

Severity Code ; 4 



IFO026 CHARACTERS APPEAR BETWEEN THE BEGIN AND CONIINCE CCLUNKS CK 
CONTINUATION CARE 

Expla nat ion; On a continuation card, the begin column and all 
columns between the begin column and the continue column 
(usually column 16) must te blank. 

Assembler Action : Characters that appear between the begin 
column and the continue column are ignored. 

Programmer Response : Determine whether the operand started in 
the wrong continue column or whether the preceding card 
contained an erroneous continue punch in column 72. 

Severity Code : 4 



IFO027 ICTL, ISEQ, MACRO, OR OPSYN STATEMENT APPEARS IN MACRO 
DEFINITION 

Expla nat ion; One of the specified operations is used within a 
macro definition, which is illegal. 

Asse m bler Action ; The illegal operation is ignored and the 
statement is processed as a comment. 

Prog rammer Response; Remove all ICTL, ISEQ, tfACRC, and CPSYfc 
statements from wi-thin macro definitions. Make sure your ICTL 
and OPSYN instructions precede your iracrc definitions, and that 
each macro definition ends with a MEND statement. 
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Severity Cede: 8 



IFC0 28 ILLEGAL PROTOTYPE KEYWORD PARAMETER DEFAULT VALUE 

Explanation : A variable symbol is used as the default value cf 
a keyword parameter. 

Assembler Action: The statement is ignored. 

Programmer Response : Supply a valid default value for the 
keyword parameter. 

Severity Cede : 8 



IFC029 



xxxxxxxx IS AN ILLEGAL OPERAND IN A GLOBAL OR LOCAL DECLARATION 



Explanation : In a global (GBLx) or local (LCIx) SET symbol 
declaration, the indicated operand does net consist cf one or 
more variable symbols that are separated by commas and 
terminated with a blank. 



Assemb ler Ac t ion : The attempted global or local SET symbol 
declaration is processed as a comment. Recovery is made in 
certain circumstances and some valid variable symbols in the 
declaration are recognized and defined correctly. 

Programmer Response : Supply the operand with valid variable 
symbols and delimiters. Check all global and local 
declarations. 

Severity Code : 8 



IFO030 



DECLARED DIMENSION OF xxxxxxxx IS ILLEGAL 



Explanation: The declared dimension, which appears in the error 
message, must be a nonzero, unsigned decimal integer, not 
greater than 32,767, and enclosed in parentheses. 

Assembler Ac tion : If the declared dimension was a decimal 
self -defining term greater than 32,767, a default dimension of 
32,767 is assigned to the variable symbol. In all ether cases, 
the variable symbol declaraticn is igncred. 

Programme r Response : Supply a valid dimension. 

Seve rity Cede : 8 



IFO031 SET STATEMENT NAME NOT A VARIABLE SYMBOL, OR SET STATEMENT NAME 
INCONSISTENT WITH DECLARED TYPE 

E xp lanation: (1) The name field of a SET statement does not 
consist of an ampersand followed by from 1 to 7 alphameric 
characters, the first of which is alphabetic. 
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(2) The symbol dees not match its previously declared type. 
For instance, the symbol might have been previously defined as 
LCLA, but the flagged statement may have tried tc assign a SETC 
character string to it. 

(3) A system variable symbol appears in the name field cf a 
SETx instruction. The system variable symbols are £SYSECT, 
SSYSLIST, 6SYSNEX, 6SYSPARM, SSYSDATE, and &SYS1IV.E. 

Assembler .fiction ; The flagged statement is processed as a 
comment. 

Programmer Response ; Assign a valid variable symbol tc the name 
field of the SET statement (the symbol must be previously 
defined as a global or local variable) , or be sure that the 
usage of the symbol corresponds tc its previously declared type. 

Severity Ced e; 8 



IFO032 XXXXXXXX APPEARS IMPROPERLY IN THE OPERAND OF THIS STATEMENT 

Explanation ; The specified operand part is invalid. 

Assembler Action ; The statement is processed as a comment. 

Programmer Response ; Check the syntax required for the operand 
field cf this statement, and supply a valid operand. 

Severity Cede ; 8 



IFO033 xxxxxxxx IS AN INVALIE LOGICAL OPERATOR 

Explanation ; The specified character string was fcund where a 
logical operator (AND or OR) was expected. 

Assembler Action ; The statement is processed as a comment. 

Programmer Response ; Use either AND or OR, as appropriate, for 
the logical operator. 

Severity Code ; 8 



IFO035 QUOTES NOT PAIRED, OR ILLEGAL TERMINATION OF QUOTE STRING 

Explanation ; The quotes in the operand field of this statement 
are unpaired, or the string is illegally terminated. 

Assembler Action ; The statement is processed as a comment. 

Progr ammer Response ; Supply any missing quotes. 

Severity Ced e; 8 
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IFC036 ATTRIEUTE REFERENCE FOR xxxxxxxx IS INVALID 



Explanation ; The flagged statement has attempted to reference a 
symbol that is not a valid ordinary or variable symbol . The 
attributes referenced were one or more of the following: type 
(T*) , length (L 1 ), scaling (S') , integer (I*), count (F*) , and 
number (N ' ) . 

Assembler Action ; The attribute referenced is ignored, and/or 
the statement is ignored, and/or default values for type, 
length, and scaling attributes are supplied. 

Programmer Response ; Determine if a clerical error was made in 
coding either the reference or the definition of the symbol that 
appears in the message text; or supply a valid ordinary or 
variable symbol where necessary. 

Severity Code ; 8 



IFO037 xxxxxxxx IS AN ILLEGAL SUBSCRIPT 

Explanation; The subscript that appears in the message text 
either is not enclosed by paired parentheses, or is an illegal 
subscript. 

Assembler Action ; The statement that contains the illegal 
subscript is processed as a comment. 

P rogrammer Response ; Ee sure the parentheses are paired, and 
that a valid subscript appears inside them. 

Severity Code : 8 



IFO038 xxxxxxxx IS AN INVALID SELF -DEFINING TERM 

Explanation ; The characters specified in the message are 
invalid in the operand field of a binary (type E) , character 
(type C) , decimal, or hexadecimal (type X) self-defining term. 

Assembler Action ; The statement that contains the invalid 
self -defining term is processed as a comment. 

Programmer Response ; Make sure that the characters used for a 
self-defining term are consistent with the type of term. 

Severity Cede ; 8 



IFO039 



xxxxxxxx IS AN INVALID VARIABLE SYMBOL 



Explanation ; The specified symbol does net consist of an 
ampersand followed by from 1 to 7 alphameric characters, the 
first of which is alphabetic. 

Assembler Action ; The statement that contains the invalid 
variable symbol is processed as a comment. If the statement is 
a macro prototype statement, all statements in the macro 
definition are treated as comments. 

Programmer Response ; Supply a valid variable symbol, or check 
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that a single ampersand is not used where a double ampersand is 
needed. 

Severity Cede ; 8 



IFO0U2 PARAMETER IN MACRO PRCTOTYFE CR MACRO INSTRUCTION EXCEEES 255 
CHARACTERS 

Exp lanation; A parameter value that appears in the operand 
field of either a macro prototype or a macro instruction exceeds 
255 characters in length- 
Assembler Action ; The first 255 characters cf the parameter are 
deleted. The remaining characters are used as the parameter 
value. 

Programmer Response ; Limit the parameter tc 255 characters or 
separate it into two or more parameters. 

Seve rity Cede : 8 



IFO043 MACRO INSTRUCTION PROTOTYPE STATEMENT HAS INVALID OF CODE 
Explanat ion ; 

• The operation code of a macro prototype statement is 
previously defined as the operation cede cf a machine, 
assembler, or macro instruction; cr 

• The operation code of a macro prototype statement is not a 
valid ordinary symbol; that is, it dees net consist cf a 
letter, followed by to 7 letters or digits or both. 

Assembler Action ; The entire macro definition is processed as 
comments. 

Programmer Response ; Supply a valid ordinary symbol that dees 
net conflict with any machine, assembler, cr iracro instruction 
operation cede. 

Severity Code ; 8 



IFO046 STATEMENT COMPLEXITY EXCEEDED 

Explanation ; The expression evaluation wcrk area has cverflowed 
because the expression is too ccmplex. The ccirplexity of an 
expressicn is determined by the number of nested operators and 
levels of parentheses. Up to 35 operators and levels cf 
parentheses are allowed. For logical expressions, this total 
allows 18 unary and binary operators, and 17 levels cf 
parentheses. Eor arithmetic expressions in ccnditicnal 
assembly, the total allows 24 unary and binary operators, and 
11 levels of parentheses. 

Assembler Action ; The statement is processed as a comment. 

Programmer Response ; Simplify the expression tc the limits 
described in the explanation. 

Severity Cede ; 8 
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IFC0U7 UNEXFECTEE ENE OE FILE CN SYSTEK INPUT (SYSIN) 
Explanation : 

• A continuation record was expected when an end-cf-file 
occurred en SYSIN (the source program ended) ; or 

• End-of-file immediately fcllcws a REFRO statement; or 

• End-of-file occurs fcefore an ENE card has teen read. 

Assembler Action : An ENE stateirent is generated and assembly 
continues. 

Prog r amm e r Response : Determine if any statements were omitted 
from the source program. 

Severity Code : 4 



IFO048 ICTL STATEMENT HAS NO OPERAND 

Expla nation : The ICTL statement requires an operand, but none 
is present. 

Assembler Action : The entire source module is processed as 
coirments. 

Pro gra mmer R e sponse : Supply from 1 to 3 decimal self-defining 
terms to indicate respectively the begin, end, and continue 
columns. If the ICTL statement is emitted, cclurrns 1, 71, and 
16, respectively, are the default values. 

Severity Cede : 8 



IFO049 CCFY STATEMENT OPERANE NOT A VALID ORDINARY SYKBCZ 

Expla nat ion: The operand of a CCFY statement is not a symbol of 
1 to 8 alphameric characters, the first of which is alphabetic. 

Assem ble r Act ion : The CCFY request is processed as a comment. 

Prcgr airmer R e sponse : Supply a valid ordinary symbol in the 
operand field. 

Severity Co de: 8 



IFO050 COPY STATEMENT DCES NCT HAVE AN CFERANE 

Explanation : No operand found en this COPY statement. 

Assembler Action : The statement is processed as a ccirirent. 

Programmer Response : Place the naire cf a meirter tc be copied in 
the operand field, or remove the COPY stateirent. 

SeverityCcde : 8 



Appendix G. Assembler Diagnostic Error Messages 



93 



IFO051 UNEXFECTEE ENE OF EATA ON SYSTEM LIBRARY (SYSLIB) 

Expl a nation : An end-of-file occurred on the input from a system 
library before a KEND statement terminating a macro definition 
was encountered. 

Assemble r Action ; The missing tfENE statement is generated. 

Programm er Response : Determine if the MEND statement was 
omitted from the library macro, or if the library contains an 
otherwise incomplete macro definition, cr if a nacre call has 
been made to a non-macro definition. 

Severity Cede : 4 



IFC0 52 UNAPY OPERATOR NOT A PLUS CR KIKUS SIGN 

Explanation ; An operator other than a plus cr minus sign 
appears as a unary operator. Except for unary cperatcrs, which 
are limited tc plus and minus signs, only one operator can 
appear between two terms. 

Assembler Action ; The statement is processed as a comment. 

Programmer Response ; Supply the missing term cr a correct 
operator. 



Severity Ced e : 8 



IFC053 CF CCEE NOT FOUND ON FIRST OR ONLY CARD 

Explanation; The complete statement name (if one is used) and 
the operation code, each followed by a blank, do not appear 
before the continuation indicator cclumn en the first card of a 
continued statement. 

Assembler Action : The entire statement is prccessed as a 
coirment. 

Prog rammer Response ; tfake sure that both the name and operation 
code of the statement appear on the first card. Check for 
syntactic errors . 

Severity Ce de : 8 

IFO054 INVALID OPERATION COEE 
Explanaticn : 

• The operation code specified is not a valid ordinary symbol; 
or 

• A variable symbol in the operation field is invalid; or 

• The resulting operation cede after substitution with or 
without concatenation is not a valid ordinary symbol. 
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assembler Action ; The statement is processed as a comment. 

Programmer Response : Make sure that ordinary cr variable 
syirbcls used in the operation field are valid. If ycu use 
variable syirbcls with or without concatenation, make sure the 
resulting symbol is a valid ordinary symbol . 

Severity Cede: 8 



IFO055 MEND STATEMENT GENERATED 

Explanation An end-of-file occurred en the input freir, the system 
input device (SYSIN) or the system library (£¥£LIB) before a 
MEND statement terminating a macro definition was encountered. 

Assembler Action : A MEND statement is generated. 

Eroqrammer Response : Supply a MEND statement tc terminate the 
macro definiticn. 

Sever ity Ced e : 8 



IFO057 DUPLICATION PACTOR XXXXXXXX IN SETC EXPRESSION NCT TERMINATED 
BY A RIGHT PARENTHESIS 

Explanation: A SETC operand begins with a left parenthesis, but 
a comma, a period, or a blank appears before the closing right 
parenthesis. 

Assembler Action : The statement is processed as a comment. 

Programmer Response : Supply a right parenthesis. 

Severity Code : 8 



IFO058 NO ENDING QUOTE ON SETC EXPRESSION 

E xpl anation: The character expression in the operand field of a 
SETC statement must be enclosed in quotes. The statement ends 
before a delimiting quote. 

Asserr bler Acticn : The statement is processed as a comment. 

Prog rammer Response : Supply any missing quotes. 

Severity Ced e : 8 



IFC059 INVALID TERM IN LOGICAL EXPRESSION 

Explanation : One of the terms in the logical expression is 
invalid in the context. 

Assembler Acticn: The statement is processed as a comment. 
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Pro gr ammer Response : Pake sure that the terms in the logical 
expression are valid. 

Severity Code : 8 



IFO060 END STATEMENT GENERATED 

Explanation : One of two errors occurred. 

(1) End-of-f ile occurred en the systeir irput device > (SYSIK) 
before an END card was read. 

(2) The ACTR limit was exceeded in open code. 
A sse m bler Action : An END statement is generated. 
Prog r ammer Response : 

(1) Supply a valid END statement; or 

(2) Either correct the conditional assembly loop in open 
code so that the ACTR limit is net exceeded, cr set the 
ACTR limit in open code tc a higher value. 

Seve rity Cede : 4 



IFC0 61 COPY NEST GREATER THAN FIVE 

Explanation : The maximum limit of five nested levels cf CCFY 
statements is exceeded. 

Assemble r Action : COPY processing terminates. 

Programmer Response : Eliminate excessive levels of COPY 
statements. 

Severity Code : 8 



IFO062 REQUIRED OPERAND FIELD MISSING 

Explanation : This statement requires an operand in the operand 
field and none is present. 

Assembler Acticn: The statement is processed as a comment. 

Prog rammer Response : Supply the missing operand. 

Seve rity Cede: 8 



IFO064 INTERLUDE DICTIONARY SPACE EXHAUSTED 

Explanaticn : The work space available is net sufficient to 
contain the dictionaries required tc build either 
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(1) The skeleton dictionary for a macro definition or all of 
open code, or 

(2) The ordinary symbol attribute reference dictionary. 

This message is always logged against statement number 0. 

Ass em bler .fiction ; If a macro is being processed, building of 
the skeleton dictionary for that macro definition is terminated 
and the macro will not be expanded. If cpen cede is being 
processed, the building of the open code skeleton dictionary is 
terminated and the program is processed as comments. If space 
for the ordinary symbol attribute reference dictionary is 
exhausted, the building of it is abandoned. 

Pro grammer Response : Within the partition, increase the size of 
the region that is allocated to assembly, or allocate more of 
the partition to dictionary space via the BUFEIZE assembler 
option (see Appendix E) . 

Sever ity Cod e: 12 



IFO065 EXPRESSION 2 OF EQU SYMEOL xxxxxxxx NOT IN RANGE 0-65535 

Explanation : The value of the expression specified in the 
second operand of the EQU instruction where this symbol is 
defined is net in the range 0-65535. 

This message is always logged against statement number 0. 

Assembler Action : The length attribute of the symbol is set to 1 

Programmer Response : Make sure the value of the secend operand 
of the EQU instruction is in the range 0-65535, cr delete the 
second operand. 

Severity Code : 8 



IFO066 EXPRESSION 3 OF EQU SYtfBCI xxxxxxxx NOT IN RANGE 0-255 

Explanation: The value of the expression specified in the third 
operand, of the EQU instruction where this symbol is defined is 
not in the range 0-255. 

This message is always logged against statement number 0. 

Assembler Action: The type attribute of the symbol is set to U. 

Program mer R e sponse : tfake sure the value of the third operand 
of the EQU instruction is in the range 0-^255, or delete the 
third operand. 

Severity Cede : 8 
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IF0067 DECLARED DIMENSION FOR GLOBAL VARIAELE xxxxxxxx IN xxxxxxxx 
xxxxxxxx IS INCONSISTENT 

Expl anation ; The declared dimension of a glotal variable 
defined in a macro definition or in open code is not consistent 
with the declared dimension of the same glcbal variable in 
ancther macrc definition or in open code. 

This message is always logged against statement number 0. The 
message text identifies the macro (or open code) where the 
error, is found. 

Asserrbler Action ; All references to the glcbal variable in the 
macrc definition or in open cede where the inconsistency was 
detected result in a null (zero) value. 

Programmer Re sponse ; Be sure that all definitions of a given 
global variable have the same declared dimension. 

Severity Code ; 4 



IFO068 COPY MEMBER xxxxxxxx NOT FOUND IN LIBRARY 

Explanation ; The COPY member shewn in the message text was not 
found in the library- 

Assem bler A ct ion ; The COPY statement is processed as a comment. 

Progr ammer Response ; Determine whether the library member name 
is misspelled or whether an incorrect member name was 
referenced. Make sure the proper macrc library is assigned in 
your JCL statements. 

Severity Code ; 8 



IFO069 TOO MANY CONTINUATION CARDS, TWO ALLOWED 

Expl anat ion ; Only two continuation cards are allowed for each 
statement, except for macro definition prototype and macro call 
statements. 

Asserrbler Action ; Excess continuation cards are processed as 
ccirments. 

Progr ammer R e sponse ; Restructure the statement so that it can 
be contained on a total of three cards. Extensive remarks may 
be recorded as comment statements by ceding an asterisk in 
ecluirn 1 and eliminating the continuation indicators. 

Severity Code ; 4 



IFO070 SUBSTRING NOTATION IS NOT DELIMITED EY COMMA OR RIGHI 
PAFENTBESIS 

Explanation ; Two SETA expressions used in substring notation 
are not separated by a comma or enclosed in parentheses. 

A sserrbler Ac ticn; The statement is processed as a comment. 
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Programmer Re sponse : Supply the missing deliiriter, or check for 
other syntax^errors that make this appear as substring notation. 

Severity Code: 8 



IFO073 AGO OR AIF OPERAND NOT A SEQUENCE SYMEOL 

Explanation : The symbol in the operand field of an AIF or AGO 
statement is not a period (.) followed by from 1 to 7 
alphameric characters, the first of which is alphabetic. 

Assembler Action : The statement is processed as a comment. 

Programmer Response : Supply a valid sequence symbol. 

Sever ity Cede : 8 



IFC074 SEQUENCE SYMEOL xxxxxxxx IS MULTIPLY DEFINED IN xxxxxxxx 
xxxxxxxx 

Explanation : The sequence symbol in the name field has been 
used in the name field of a previous statement within the same 
macro definition or open code. 

This message is always logged against statement number 0. The 
message text identifies the macro {or open code) where the 
error is found. 

■Assembler Action : All definitions of the sequence symbel after 
the first one are ignored. All references tc the sequence 
symbel are treated as references to the first definition. 

Programmer Response : Provide unique sequence symbols for the 
macrc definition or open code. 

Seve rity Cede : 4 



IFO076 SEQUENCE SYMEOL xxxxxxxx IS UNDEFINED IN xxxxxxxx xxxxxxxx 

Explanation : A sequence symbol appears in the operand of an AIF 
or AGO statement , but does not appear in the name field of 
another statement in the same macro definition cr cpen cede. 

This message is always logged against statement number 0. The 
message text identifies the macrc (cr cpen cede) where the 
error is found. 

Assembler Action : All statements which reference the undefined 
sequence symbel are processed as comments. 

Prog ramme r Response : Define the sequence symbol at the 
appropriate point, or reference a sequence symbol that is 
already defined. 

Severity Cede : 4 
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IF0078 UNDEFINED OP CODE 

Expl anat ion ; The mnemonic operation code of this statement does 
not correspond to any of the following: 

a machine instruction operation cede 

an extended machine instruction operation code 

an assembler instruction operation cede 

a macrc instruction operation code 

an operation code that has teen defined 

by an OPSYN instruction. 
This message is also issued for operation cedes that have been 
deleted by OPSYN instructions. 

assembler .Action ; The statement is treated as a comment. If 
the statement appears before open cede, all statements 
fcllcwing it are considered to belong to open code. This means 
that any macro definitions following the error are treated as 
errors. 

Programmer Response : Either make sure ycu use a valid mnemonic 
operation cede, cr make sure that the proper OPS¥N instructions 
are included in your program. 

Severity Code ; 8 



r 



IFO080 ATTRIBUTE REFERENCE TO UNDEFINED SYtfEOL 

E xplanation ; The symbol specified in a length (L 1 ) , scaling 
(S 1 ) , or integer (I 1 ) attribute reference is either an 
undefined symbol or a symbolic parameter (cr a SSYSLIST 
specification) representing an undefined symbol. 

Asse m bler Action : 

• The length attribute, if specified, is set to 1. 

• The integer or scaling attribute, if specified, is set to 0. 
Programmer Response ; Kake sure the symbol is defined. 
Sever ity Cede : 4 



IFO081 DECLARED TYPE FOR GLOBAL VARIABLE xxxxxxxx IN xxxxxxxx xxxxxxxx 
IS INCONSISTENT 

Explanation: The type (GELA, GBLB, cr GBLC) cf a global 
variable declared in a macro definition or in open code is not 
consistent with the type of the same global variable declared 
in another macro definition or in open code. 

This message is always logged against statement number 0. The 
message text identifies the macro (or open code) where the 
error is found. 

Assembler Action ; All references to the global variable in the 
macrc definition or in open cede where the incensistency was 
detected result in a null (zero) value. 

Progra mmer Response ; tfake all declarations of the same global 
variable consistent. 

Severity Code ; 4 
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IFO085 MACRO HEADER MISSING, MACRO NOT EXPANDABLE 

Exp lanation: The first statement of a library macro definition 
was not a MACRO statement, and the search for the macro 
definition is terminated. 

Assembler Action ; The macro call is processed as a ccirment. 

Programmer Response : Ee sure that the library macro definition 
begins with a MACRO statement. 

Severity Cede : 8 



IFC087 INVALID MACRO DEFINITION PROTOTYPE, MACRO NOT EXPANDABLE 

Explanat ion: A comment statement appears iirirediately after a 
macro header (MACRO statement) . 

Asse mbler Action : All the statements of the macro definition 
are processed as comments. 

Programmer Response : Make sure that the staterrent immediately 
following the macro header is a macro prototype statement. Kc 
comments cr any ether statements are permitted between the macro 
header and the prototype of a macro definition. 

Severity Ced e: 8 



IFO088 LIERARY MACRO PROTOTYPE DOES NOT MATCH MEMBER NAME, MACRO NOT 
EXFANDAELE. 

E xplanation : The mnemonic operation code in the macro prototype 
in a library macro definition does not match the entry in the 
macro library. 

Asse mbler Action : The macro instruction is processed as a 
comment. 

Programmer Response : Enter the macro definition in the library 
under the same name as the mnemonic op cede that appears on the 
macro prototype. 

Severity Code: 8 



IFO089 GENERATION- TIME DICTIONARY SPACE EXHAUSTED 

Explanation : The workspace available is not sufficient to 
contain the dictionaries required to expand the macro, to extend 
a SETC variable, or to contain the basic global dictionaries. 



Asse m bler Action : If the global dictionary workspace is 
insufficient , the text is processed as comments. If there is 
insufficient space to extend the SETC variable, expansion of 
the macro that contains the variable is terminated. If the 
space for macro definition dictionaries is insufficient, calls 
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to those macros are not expanded. 

Programmer Response ; Within the partition, increase the size of 
the region that is allocated to assembly, or allocate more of 
the partition to dictionary space via the BUFSIZE assembler 
cpticn (see Appendix E) . 

Seve rity Code ; 12 



IFO090 UNDEFINED SEQUENCE SYMEOL ENCOUNTERED DURING CONDITIONAL 
ASSEMBLY 

Explanation ; A sequence symbol referenced in the operand field 
cf this statement is undefined in the macro definition or open 
code. This statement has been encountered during conditional 
assembly. 

Assem bler Action ; The statement is processed as a comment. 

Prcq ramirer Response ; Define the sequence symbol at an 
appropriate point, or reference a sequence symhol that is 
already defined. 

Severity Cede ; 8 



IFO091 KEYWORD PARAMETER XXXXXXXX IS DUPLICATED ON SME MACRO CALL 

Explanation; A keyword parameter has appeared more than once on 
the same macro instruction. 

assembler action ; The last value assigned tc the parameter is 
used, the ether value (s) are ignored. 

Programmer R esponse ; Define only one value for each parameter. 

Severity Cede; 8 
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IFO092 KEYWORD PARAMETER xxxxxxxx UNDEFINED IN MACRO DEFINITION 

Explanation ; A keyword parameter has been used in the macro 
instruction that is not a keyword parameter in the macro 
prototype, or an equal sign not surrounded by quotes is found 
in a positional parameter. 

Assembler Action ; The extra keyword parameter in the macro 
instruction is ignored. 



(1) Delete the keyword parameter and its value from the macro 
instruction ; or 

(2) make the keyword parameter in the macro call correspond to 
one of the keyword parameters in the macrc prctctype; or 

(3) define the keyword parameter in the operand field of the 
macro prototype; or 
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(4) if ycu want to include an equal sign in a positional 
parameter, enclose the parameter within single quctes. 

Severity Code : 8 



IFO100 DICTIONARY SPACE EXHAUSTED, NO SKELETON DICTIONARY BUILT 

Explanation : 

© If the message is given for a macro definition or for open 
cede: no available space is left to build the skeleton 
dictionary after space has teen used for the definition of 
global symbols, sequence symbols, or referenced ordinary 
symbols. 

« If the message is given for a macro instruction: dictionary 
space was exhausted during the editing of a library macro. 

Assemb ler Action : The macro is net considered defined, and any 
calls to it are processed as comments. If the error occurs in 
cpen code, the entire assembly is processed as comments. 

Progra mmer Response : Within the partition, increase the size of 
the region that is allocated to assembly, or allocate more of 
the partition to dictionary space via the BUFSIZE assembler 
cpticn (see Appendix E) . 

Severity Code : 8 



IFO101 GENERATED OP CODE INVALID OR UNDEFINED 

Explanation: The operation code created by substitution is not 
a valid ordinary symbol or is not a valid machine, assembler, 
or macro instruction, or defined by an OPSYN instruction. 

A sse mbler Action: The generated statement is treated as a 
coirment. 

Programmer Response : Ee sure that substitution results in a 
valid ordinary symbol that consists of frcm 1 tc 8 alphameric 
characters, the first of which is alphabetic, and that the 
resulting symbol is a defined operation cede. 

Severity 



IFC102 GENERATED OP CODE IS BLANK 

Explanation: The op code created by substitution contains no 
characters, or from 1 to 8 blank characters. 

Asse m bler Action : The generated statement is processed as a 
comment. 

Fr eg rammer Response : Ee sure that substitution results in a 
valid ordinary symbol that consists of frcm 1 tc 8 alphameric 
characters, the first of which is alphabetic. 

Seve rity Cod e: 8 
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IFO104 MORE THAN ONE TITLE STATEMENT NAKED 

Explanation : This is at least the second TITLE statement that 
contains something other than a sequence symbol cr blanks in 
the name field. 

Assembler Action : The name field is ignored. 

Programmer Response : Be sure that the name fields of all but 
one TITLE statement contain only sequence syirbcls or blanks. 

Seve rity Cede : 4 



IFC105 



GENEBATEX FIELD EXCEEDS 255 CHARACTERS 



Explanation : As a result of substitution, a character string 
that is longer than 255 characters has been generated. 

Asse mbler Action : The first 255 characters are used. 

'Prog rammer Response : Limit the generation of any character 
string to 255 characters, minus the number of non-substituted 
characters. (Limit substitution in the name and cperaticn 
fields tc 8 characters, in the operand field to 255 characters.) 

Seve rity Code : 8 



IFO107 CHARACTER STRING USED AS AN ARITHMETIC TERM EXCEEDS 10 
CHARACTERS 

Explanat ion: A character string used in a SETA expression or in 
an arithmetic relation in a SETE expression is longer than 10 
characters. Ten is the maximum number of characters permitted 
in a decimal self-defining term. 

Assembler Action : The character string is replaced by an 
arithmetic value of zero. 

Programmer Response : Be sure that all character strings used as 
described in the explanation are from 1 to 10 decimal digits 
with a value in a range of to 2,147,483,647. Alsc be sure 
that the values of all variables that contribute to the 
generation of the character string are valid for their type. 



Severity Ce de : 8 



IF0108 CHARACTER STRING USEE AS AN ARITHMETIC TERM CONTAINS NON-DECIMAL 
CHARACTERS 

Expla nation : A character string used in a SETA expression or in 
an arithmetic relation in a SETE expression contains characters 
ether than through 9. 

Asse mbler Action : The character string is replaced by an 
arithmetic value of zero. 

Programmer Response : Ee sure that all character strings used in 
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a SETA expression cr as an arithmetic relation in a SE1E 
expression contain from 1 to 10 deciiral digits with a value in 
the range of to 2,147,483,647. Also be sure that the values 
of all variables that contribute to the generation of the 
character string are valid for their type. 

Severity Code ; 8 



IFO109 CHARACTER STRING USED AS ARITHMETIC TERM IS A NEIL SIRING 

Exp lanation: A character string used in a SETA expression or in 
an arithmetic relation in a SETE expression is zero characters 
in length. 

Assemble r Acticn ; The character string is replaced by an 
arithmetic value of zero. 

Programmer Response : Ee sure that all character strings used in 
an arithmetic context are froir 1 to 10 deciiral digits with a 
value in a range of to 2,147,483,647. Also make sure that 
the values of all variables that contribute tc the generation 
of the character string are valid. 

Severity Code: 8 



IFO110 ARITHMETIC OVERFIOW IN INTERMEDIATE RESULT 01 SE1A EXPRESSION 

Explanation: During the evaluation of a SETA expression, an 
intermediate value was produced that was outside the range of 
-231 to 231-1. 

Asse mble r Ac t ion : The intermediate result is replaced by an 
arithmetic value of zero. 

Programmer Response : Ee sure that the values cf all variables 
that contribute to the intermediate result are valid. No 
expression shculd ever attempt a value outside the range of 
-231 to 231-1. Overflow may te avoided if ycu adjust the 
sequence cf expression evaluation, or if you separate 
components of the expression and evaluate their individually 
(perhaps by additional SET statements) before combining them. 

Severity Code : 8 
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IF0111 SUESCRIPT EXPRESSION HAS A ZERO OR NEGATIVE VALUE 

Explanation : A term or a SETA expression used as the subscript 
en a dimensioned glefcal cr local variable syirbcl results in a 
zero cr negative value. 

Assembler Action ; Any such reference tc the dimensioned 
variable results in a null (zero) value. 

Progra mmer R e sponse ; Be sure that the values of all the 
variables that contribute to the subscript are valid. 
Expressions that are used as subscripts must have a value in 
the range cf 1 through the declared dimension of the global or 
local variable. A zero sufcscript is allowed enly on the system 
variable SSYSLIST. 

Seve ri ty Cod e: 8 
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IF0112 SUESCRIPT EXPRESSION EXCEEDS MAXIMUM DIMENSION 

Expla nation ; A term or a SETA expression used as the subscript 
on a dimensioned global or local variable results in a value 
greater than the declared dimension of the variable. 

Assemble r Action ; Any such reference results in a null (zero) 
value. 

Programmer Response ; Ee sure that all terms and variables that 
contribute tc the subscript have valid values. Be sure that a 
term cr a SETA expression used as a subscript has a value in 
the range of 1 through the declared dimension cf the global or 
local variable. 

Severity Code : 8 



IFO 1 1 3 



ILLEGAL REFERENCE KADE TC A PARAMETER THAT IS A SUELIST 



Explanation ; A reference has been made in a SETA cr SETB 
expression (i.e., in an arithmetic context) tc a parameter that 
is a sublist. 

Assembler Action ; The reference to the parameter results in an 
arithmetic value of zero. 

Prog rammer Response ; Check to see that the proper parameter is 
being referenced. Be sure that an appropriate value is 
assigned to a parameter that is referenced in a SETA cr SETB 
expression. Check for a missing subscript. 

Severity Code ; 8 



IFO 114 NEGATIVE DUPLICATION FACTOR IN CHARACTER STRING 

Explanation ; A term or a SETA expression that is used as the 
duplication factor in a SETC operand results in a negative 
value. 



Assembler Action ; The duplication factcr is set to an 
arithmetic value of zero. 
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Programmer Response : Ee sure that any term cr expression used 
as a duplication factor has a positive value, and that the 
values cf all variables that contribute to the duplication 
factor are valid. 

Seve rity Ce de: 8 



IF0115 FIRST EXPRESSION IN SUBSTRING NOTATION HAS ZERO CR NEGATIVE 
VALUE 

Explanation : A term or SETA expression that is used tc specify 
the starting character for a substring operation has a zero or 
negative value. 

Assembler Action : The assembler assigns the value cf null to 
the substring. 

Programm er Response : A term, a SETA expression, or a 
combination of variables used to produce the first expression 
in a substring notation must result in a positive, nonzero 
value, net exceeding the length of the character string. 

8 



IF0116 



SECOND EXPRESSION IN SUESTRING NOTATION HAS NEGATIVE VALUE 



Explanation : A term or SETA expression that is used tc specify 
the number cf characters affected by a substring operation has 
a negative value. 

Assembler Action : The value of the second expression cf the 
substring notation is set to 0, that is, the assembler assigns 
a value cf null to the substring. 

Progra mmer Res ponse: A term, a SETA expression, cr a 
combination of variables used to produce the second expression 
in a substring notation must result in a non- negative value. 

Severity 



IF0117 FIRST EXPRESSION IN SUESTRING NOTATION EXCEEDS THE LENGTH OF 
THE STRING 



Explanation : A term or SETA expression that specifies the 
starting character for a substring operation specifies a 
character beyond the end of the string. 

Assembler Action : The assembler assigns the value cf null to 
the substring. 

Pro grammer Response : tfake sure the term, SETA expression, or 
combination of variables used to produce the first expression 
in a substring notation results in a value in the range cf 1 
through the length of the character string. 

Severity Code: 8 
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IF0118 ACTR LIMIT HAS EEEN EXCEEEED 

Explanation: The number of AIF and AGO branches within the text 
segment exceeds the value specified in the ACTR instruction or 
the conditional assembly loop counter default value. 

Assemble r Action : If a macro is being expanded, the expansion 
is terminated. If open code is processed, all remaining 
statements are processed as comments. 

Pro grammer Response : Correct the conditional assembly loop that 
caused the ACTR limit to be exceeded, or set the ACTR value to 
a higher number. 

Severity Code : 8 



IF0119 ILLEGAL TYPE ATTRIBUTE REFERENCE 

Explanation : A type attribute reference is made to a symbol 
defined by an EQU instruction with an invalid third operand. 

A ssemb le r Action : The type attribute value is set to U. 

Programme r Response : Correct the third operand on the EQU 
instruction. It must be a self-defining term in the range 
0-255. 

Severi ty Cede : 4 



IFO120 ILLEGAL LENGTH ATTRIBUTE REFERENCE 



r 



Expl anaticn : 

• A length attribute reference specifies a SETx symbol; or 

• A length attribute reference specifies a symbolic parameter 

(or a SSYSLIST representation) that does net represent an 
ordinary symbol ; or 

• The ordinary symbol referenced by a length or integer 
attribute reference is defined by an EQU instruction, and 
the value of the second operand of that instruction is not 
in the range 0-65535; or 

• The ordinary symbol referenced by a length or integer 
attribute reference is defined in a DC cr DS instruction, 
and the instruction contains a length modifier that is not 
a self-defining term. 

Assembler Action : The length attribute is set to 1. 

Programmer Response : Review the use of the length attribute and 
recede. 

Severity Code : 4 
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IFC123 ILLEGAL SCALE ATTRIEUTE REFERENCE 

Explanation ; 

e A scaling attribute reference specifies a SElx symbol; or 

© A scaling attribute reference specifies a symbolic 

parameter (or a SSYSLIST representation) that dees net 
represent an ordinary symbol; or 

• A scaling attribute reference is made to an ordinary symbol 
whose type attribute is net H, F, G, E, E, L, K, F, cr Z; or 

• The ordinary symbol referenced by a scaling or integer 
attribute reference is defined in a EC cr D£ instruction 
containing a scaling modifier that is not a self-defining 
term. 

Assembler Action ; The scale attribute is set to 0. 

Programmer Re sponse ; Review the use of the scale attribute and 
recede. 

Severity Ced e; 4 

IF0124 ILLEGAL INTEGER ATTRIBUTE REFERENCE 
Explanation ; 

• An integer attribute reference specifies a SETx symbol; or 

• An integer attribute reference specifies a symbolic 
parameter (or a SSYSLIST representation) that dees net 
represent an ordinary symbol; or 

• An integer attribute reference is made to an ordinary symbol 
whose type attribute is net H, F, G, E, D, L, K, F r cr Z. 

Assembler Action : The integer attribute is set to 0. 

Prcgra mmer Response ; Review the use of the integer attribute 
and recode. 

Severity Code ; 4 



IF0125 INVALID NAME - ILLEGAL EMBEDDED CHARACTER OR NON-ALP BAEETIC 
FIRST CHARACTER 

Explanation; 

• The symbol generated in the name field does not begin with 
an alphabetic character or it contains a special character 
cr an embedded blank after substitution; or 

9 for the TITLE instruction: the name field contains a 
special character. 

Assemble r Acticn ; The name field is ignored. 

Prcgramme r Response : Be sure that the symbol generated in the 
name field confbrms to the rules for forming valid ordinary 
symbols, or is a valid TITLE naire field entry. Alsc check to 
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make sure that the values of all variables that contribute to 
the generation of the symfcol in the naire field are valid. 

Seve rit y Cede : 8 



IF0126 MORE THAN 5 ERRORS IN THIS STATEMENT, PROCESSING OF THE 
STATEMENT IS TERMINATED 

Explanation : Six or more errors were detected in processing 
this statement. The maximum number of errcr iressages issued by 
the processor to each statement is. five. 

Assemble r Action : The sixth error causes this message to be 
issued, and messages are not issued for any further errors in 
this statement. 

Programmer Response : Correct the indicated errors and check 
carefully fcr errors beyond the point indicated by the fifth 
error message. Assemble again. Any additional errors will be 
located in the next assembly. 



Severity Cede : 8 



IF0127 VALUE OF CHARACTER STRING USED IN ARITHMETIC CONTEXT EXCEEDS 
2,147,483,647 

Expla nation : A character string used in a SETA expression or in 
an arithmetic relation in a SETE expression exceeds a value of 
2,147,483,647, which is the maximum value allowed fcr a decimal 
self-defining term. 

Assembler Action : The character string is replaced by an 
arithmetic value of zero. 

Prog rammer Response : Be sure that all character strings used in 
an arithmetic context are from 1 to 10 decimal digits and have 
a value in the range of to 2,147,483,647. Be sure that the 
values of all variables that contribute to the generation of 
the character string are valid. 

Severity Cede: 8 



IF0128 GENERATE! OP CODE EXCEEDS 8 CHARACTERS 

Explanation: The syntax for mnemonic operation codes must 
follow the same rules as ordinary symbols; that is, they must 
be from 1 to 8 alphanumeric characters leng and the first 
character must be alphabetic. 

Assembler Action : The statement that contains the illegal op 
cede is processed as a comment. Only the first 8 characters of 
the generated cp cede appear in the printed statement. 

Programmer Response : Ee sure that the values cf all variables 
that contribute to the generation of the cp cede are valid, and 
be sure that nc attempt is made to generate an op code of more 
than 8 characters. 

Seve rity Cede : 8 



r\ 
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IF0129 GENERATED SYMEOL IN NAME FIELD EXCEEDS 8 CHARACTERS 

Explanation : A generated symbcl that appears in the name field 
exceeds 8 characters. It should fce from 1 tc 8 alphanumeric 
characters in length, and the first character should te 
alphabetic. 

Assembler Acticn : The name field is igncred. Only the first 
eight characters of the generated symbol appear in the printed 
statement. 

Programmer Response : Ee sure that the values cf all variables 
that contribute to the generation of the symbol in the name 
field are valid. Ee sure that no attempt is made tc generate a 
symbcl cf mere than 8 characters. 

Severity Cede : 8 



IFO130 FIRST SUBSCRIPT CF SSYSLIST REFERENCE IS NEGATIVE 

Explanation: A term, or an arithmetic (SETA) expression that is 
used as the first subscript of a SSYSLIST reference has 
resulted in a negative value. 

Assenbler Acticn : The parameter reference is treated as a 
reference tc an emitted operand. 

Prog rammer R esponse : Be sure that the values of all variables 
that contribute to the generation of the first subscript are 
valid. 



IF0131 INCONSISTENT GLOEAL VARIAELE DECLARATION! SETx INSTRUCTION 
IGNORED 

Explanation : Global variable declaration inconsistent with a 
previous definition of the variable in another macro definition 
or in open cede. 

Assembler Action : The value of the global variable remains the 
same and the SETx instruction is igncred. 

Programmer R esponse : Correct all inconsistencies between global 
variable declarations regarding dimension and type. 

Severity Code : 8 



IF0132 REFERENCE TO INCONSISTENTLY DECLARED GLOEAL VARIAELE RESULTS IN 
ZERO VALUE 

Explanation: An attempt to obtain a value from a global 
variable has been ignored because the declaration of the global 
variable was inconsistent with a previous declaration cf the 
same variable in another macro definition or in open code. 
Either the dimension or the type does net agree. 
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Assembler Action ; The reference to the global variable is 
replaced by a null or zero value. 

Programmer Response : Correct all inconsistencies among 
declarations of the same global variable. 

Severity Code: 8 



IF0133 NO WORK SPACE FOR OPEN CODE SKELETON DICTIONARY 

Explanation : The allotted dictionary work space is insufficient 
to build the skeleton dictionary for open code. Since the 
generation process requires the open code dictionary, 
generation is not attempted. 

Assembler Action : The entire assembly is processed as comments. 

Programmer Response : Within the partition, increase the size of 
the region that is allocated to assembly, or allocate more of 
the partition to dictionary space via the BUFSIZE assembler 
option (see Appendix E) . 

Severity Code : 12 



IF0157 DC OPERAND VALUE TOO LONG 

Explanation : The object code generated from an operand in a DC 
instruction is too long. The maximum object code length of a 
DC operand is 16,777,215 bytes. 

Assembler Action : The specified value is ignored. 

Programmer Response : Make the constant shorter, or break it up 
into two constants. 

Severity Code : 8 



IF0158 NAME OF STATEMENT IN DSECT USED IN RELOCATABLE ADDRESS CONSTANT 

Explanation : A non-paired relocatable term used in an A-type or 
Y-type address constant is defined in a dummy section - 

Assembler Action : The constant is ignored. 

Programmer Response : 

• Make sure the relocatable term is not defined in a dummy 
section; or 

• Make sure the term defined in the dummy section is paired 
with another term (with the opposite sign) from the same 
dummy section. 

Severity Code: 8 
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IFC159 PELOCATAELE EXPRESSION AS EXPLICIT DISPLACEMENT IN S-TYPE 
CONSTANT 

Explan a tion: The displacement used in an explicit S-type 
address constant specification is a relocatable expression. 

Assembler Action : The value of the operand is set to zero and 
no entry is made in the relocation dictionary. 

Programm er Re sponse; Make sure the displacement is specified as 
an absolute expression, or specify an implicit address. 

Seve rity Cede : 8 



IF0161 INVALIE LITERAL NEAR OPERAND COLUMN nn 

Explanation : An invalidly constructed literal appears near the 
specified operand column. 

Assembler Action : The value of any reference to the invalid 
literal is set to 0. 

Programme r Response : A literal should be constructed like a EC 
or DS constant with the following exceptions: 

© The literal is preceded by a equal sign. 

© The duplication factor must not be 0. 

Seve rity Cede : 8 



IF0162 VALUE ERROR - SHOULD EE BETWEEN AND 9 NEAR OPERAND COLUMN nn 

Explanation : A value is negative or is net in the range of to 
9, which is required by this instruction. 

Assembler Action: Zeros are generated in place of the machine 
instruction in the object module. 

Programmer Response : Ee sure the operand field has a positive 
value in the range of to 9. 



IF0163 MISSING OR INVALID SYMBOL IN NAME FIELD 

Explanation: One of two errors has occurred: 

© A symbel is missing in the name field where one is required. 

© The symbol in the name field is invalid. 

Assem bler Action : The statement is processed as a comment. 

Prcg rairmer Respo nse: Supply a valid name. 

Severity Cede : 4 
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IF0164 INVALID OR ILLEGAL START STATEMENT 

Explanation ; The START statement did net start the first 
control section in the assembly, or the operand on the START 
statement was not an absolute value. 

f i 
Assembler Action ; The START statement is treated as a CSECT v / 

statement. 

Prog rammer Response ; Be sure that the START statement has an 
absolute operand and that it begins the first control section 
in the assembly. 

Severity Code ; 4 * 



IF0165 NULL PUNCH OPERAND OR PUNCH OPERAND EXCEEDS 80 CHARACTERS 

Expl anation; The operand of a PUNCH instruction either 
specifies only a null string surrounded by quotes, or is more 
than 80 characters long. 

Assembler Action ; The PUNCH statement is processed as a comment. 

Programmer Response ; Ee sure that the operand of a PUNCH 
statement consists of from 1 to 80 characters surrounded by 
quotes. 

Severity Code ; 4 



IF0167 SYMBOL FILE OUT OF STEP 

Explanation ; References to the symbol file (an internal data 
file) cut of step because of an error in the scurce cede. This 
message is always accompanied by other error messages, not 
necessarily for the same statement. 

A ssembler Action ; Assembly continues, but results subsequent to 
the point of errcr may not be valid. 

Prog rammer Response ; This message will always be accompanied by 
user errors. Correct them and reassemble the program. 

If the message is issued even though the scurce cede is 
errcr- free, dc the following before calling IEM: 

• * Have your source program, macro definitions, and associated 

listings available. 

• If a COPY statement was used, execute the IEBFTPCH utility 
to obtain a copy of the partitioned data set member 
specified in the COPY statement. 

• Make sure that MSGLEVEL= (1, 1) was specified in the JCE 
statement. 

Severity Cede ; 16 
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IFC168 AN ARITHMETIC EXPRESSION NOT USED IN CONDITIONAL ASSEMELY 
CONTAINS MORE THAN 20 TERMS 

Explanation : An arithmetic expression used in a macro 
definition or in open code, but not in a conditional assembly 
statement, contains more than 19 unary and birary operators and 
6 levels of parentheses. The maximum nuirber cf terms this 
combination allows is 20. 

Asse mbler Action ; The value of the expression is set to 0. 

Programmer Response ; Be sure that this arithmetic expression 
dees net contain more than 19 operators (unary and binary) and 
6 levels of parentheses. If greater complexity is necessary, 
use EQU statements to evaluate intermediate results. 

Seve rity Code ; 8 



IF0169 INVALID SELF-DEFINING TERM NEAR OPERAND COLUMN nn 

Explanation ; A self-defining term, was invalidly specified. 
Assembler Action ; The value of the term is set tc zerc. 
Programmer Response ; Check the syntax and correct the error. 
Severity Code : 8 



IFO170 TWO ADJACENT BINARY OPERATORS, OR BINARY OPERATOR EXPECTED BUT 
NOT FOUND NEAR OPERAND COLUMN nn 

Explanation; One of two errors has occurred. 



(1) Two binary operators appear consecutively near the column 
specified in the message text. This applies only to W * M 

(multiply) and "/" (divide) . 

(2) A binary operator was expected near the column specified in 
the message text, but none was found. A single binary operator 
must occur between all terms of an expressicr. 

Assembler Action ; The expression that contains the absent or 
illegal operator is set to zero. 

Programmer Response : 

(1) Eliminate one of the binary operators. 

(2) Provide a binary operator. 

Severity Cede : 8 



IF0171 TITLE STATEMENT OPERAND EXCEEDS 100 CHARACTERS 

Explanation ; The operand of a TITLE instruction contains more 
than 100 characters. 
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Assembler Action; The character string in the operand is 
truncated to 100 characters. 

Programmer Response : Ee sure that the length cf the character 

string in the operand of a TITLE statement dees net exceed 100 

characters. /^\ 

V J 
Severity Code : 4 



IF0172 VALUE OF ORG OPERAND IS LESS THAN THE CONTROL SECTION STARTING 
AEERESS 

Expl an ation : The operand of an ORG statement results in a value 
less than the starting address of the control section. 

Assembler Action : The ORG statement is processed as a comment 
and has nc effect on the value cf the location counter. 

Prog rammer Response : Be sure that the operand of the ORG 
statement is a positive relocatable expression, greater than 
the starting address of the control section, cr blank. 

Severity Code : 8 



IF0173 ONE OR MORE SYMBOLS IN AN ORG OPERAND DO NOT BELONG TC THE 
CURRENT CSECT, ESECT, CR COM 

Explanation : One or more of the symbols used in the operand of 
an ORG statement are not defined in the current control section 
(dummy, common or ordinary) . 

Asse m bler Action : The ORG statement is processed as a comment 
and the value of the location counter remains unchanged. 

Programmer Response : Ee sure that all symbols used in the 
operand field cf an ORG statement belong to (are defined by 
appearing in the name field of a statement within) the current 
control section. 



Severity Cede : 8 



IF0174 ORG OPERAND IS ABSOLUTE, MUST EE RELOCATAELE 

Explanation : An absolute term or expression used in the operand 
of an ORG statement must be a relocatable term, a relocatable 
expression, or a blank. 

Assembler Action : The ORG instruction is processed as a comment 
and the value cf the location counter reirains unchanged. 

Pro grammer Response : Be sure that the operand of an ORG 
statement is a relocatable term, a relocatable expression, or a 
blank. An ORG to an absolute address is net possible because 
the assembler assumes that all location references are 
relocatable. A common error is an ORG tc 0. Since the start 
cf the program is not absolute machine location tut 
relocatable 0, replace the with a symbcl cr expressicn that 
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makes reference to the lateled prcgrair start. 
Severity Cede : 8 

IFC17 5 OPERAND SHOULD EEGIN WITH A QUOTE 

Explanation ; A quote was expected tc begin a character string 
in the operand field, tut was net fcund. 

Assembler Action ; The invalid character string is ignored. 

Programmer Response : Supply the missing leading quote in the 
character string of the operand. 

Severi ty Cede ; 8 



IFC176 UNPAIRED AMPERSAND NEAR OPERAND COLUMN nn 

Explanaticn ; A single ampersand followed by a blank was found 
in a quoted character string. If an ampersand is desired as a 
character in a quoted character string, two ampersands must be 
coded. Ampersands must be either paired cr part cf a valid 
variable symbol. 

Assembler Action ; The character string that contains the 
illegal ampersand is ignored. 

Prog rammer Response ; Determine whether the ampersand is desired 
as a character in a quoted character string or whether the 
ampersand is intended as the beginning of a valid variable 
symbcl, and correct the error. 

Severi ty Code ; 8 



IFC177 MISSING OPERAND 

Explanat icn ; This statement requires an operand, but none is 
found. 

Assembler Action ; The statement which lacks the cperand is 
prccessed as a comment. 

Prcqr air.mer R e sponse : Supply a valid operand. 

Severity Cede : 1 2 



IF0178 SYNTAX ERROR NEAR OPERAND COLUMN nn 

Explanaticn; A syntax error has occurred in the operand of this 
statement. 

Assembler Action ; The statement which contains the invalid 
cperand is prccessed as a comment. 

Programm er Response ; Correct the syntax of the operand. There 
are a large number of syntactic errors that can produce this 
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diagnostic. Ml of them require careful checking cf the syntax 
of the specific type of statement being processed. The error 
is logged at the point where the syntax beccires ambiguous or 
unrecognizable, not necessarily at the point where the actual 
error occurs. 

Severity Cede : 8 



IF0179 OPERAND SUBFIE1D NEAR OPERAND COLUMN nn MUST EE AESOLUTE 

Explanation : All terms and expressions used in the operand 
field of this statement must result in an absolute value. 

Assembler .fiction : The operand is processed as a comment. 

Programmer Response : Ee sure that each term cr expression used 
in the operand field of this statement has an absolute value. 
No relocatable expressions are allowed. 

Severity Code : 8 



IFO180 OPERAND 2 OF CNOP MUST BE EITHER 4 CR 8 

E xplanation : The second operand of a CNOP statement must be 
either 4 or 8. 

Assembler Action : The CNOP statement is processed as a comment 
and no alignment is performed. 

Programmer Response : Be sure that the second operand of a CKCF 
statement is either a 4 or an 8 . 

Severity Code : 12 



IF0181 OPERAND 1 OF CNOP MUST BE 0, 2, 4, OR 6 

Explanat ion: The first operand of a CNOP statement must be 0, 
2, 4, or^6. 

Assem bler Action : The CNOP statement is ignored and no 
alignment is performed. 

Programmer Response : Ee sure that the first operand cf a CNOP 
statement is a 0, 2, 4, or 6. 

Severi ty Cede: 12 



IF0182 OPERAND 1 OF CNOP IS NOT LESS THAN OPERAND 2 

Explanation : The value of the first operand cf a CNCP statement 
must be less than the value of the second operand. 

Asse mbler Action : The CNOP statement is processed as a comment 
and no alignment is performed. 
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Programm er Response : Check the validity of each operand of the 
CNOP statement to be sure that the value of the second operand 
is greater than the value of the first operand. 



IFC183 MNCTE/CCW OPERAND EXCEEDS 255 

Explanation ; The value of an operand used as an MN01E severity 
cede or as the first operand in a channel ccirirand word (CCK) 
exceeds 255. 

Assembler Action ; The MNOTE is processed as a ccrrirent. Space 
is allocated fcr the CCW, tut the value for the flagged operand 
is set tc 0. 

Programmer Response ; Check the validity cf the operand. 

Severity Code ; 12 



IF0184 INVALID RANGE CN CCW NEAR OPERAND COLUMN nn, 65535 IS NAXIMUN 
VALUE 

Expl anation: The value of the fourth operand of a channel 
command word has exceeded X'FFFF* (65535) . 

Assem bler Action : Space is allocated fcr the CCW, but the value 
of the flagged operand is set to 0. 

Programmer Response ; Check the validity cf the fcurth operand 
cf the channel command word. 



Seve rity Cede : 1 2 



IF0185 ELANK EXPECTED AS A DELIMITER NEAR OPERAND COLUMN nn 

Explanation ; A blank was expected as a delimiter but none was 
found. Subsequent characters have no syntactic meaning, and 
the statement is ambiguous. 

Assembler Action : The statement that contains the invalid 
delimiter is processed as a comment. 

Prog rammer Response : Supply a blank delimiter. 

Severity Cede: 8 



IF0186 INVALID SYMEOL NEAR OPERAND COLUMN nn OF ENTRY, EXTRN, OR WXTRN 

Explanation : An improperly constructed symbel was found in the 
operand field of an ENTRY, EXTRN, or WXTRN statement. 

Assem bler Acticn : The statement that contains the invalid 
symbol is processed as a comment. 
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Ercgrammer Response : Ee sure that the syirbcl in the operand 
field of EXTRN, WXTRN, or ENTRY statements certain from 1 to 8 
alphameric characters, the first of which is alphabetic. 

Seve rit y Code : 8 



IF0187 SYMECL LONGER THAN 8 CHARACTERS NEAR OPERAND COLUMN NN 

Explanation : A symbol that is mere than 8 characters in length 
has appeared in the operand field of this statement. 

Asse mbler Action : The invalid symbol in the operand field is 
replaced by a zero. 

Programmer Response : Ee sure that symbols dc net exceed 8 
characters in length. A missing cr misplaced delimiter cr 
operator may cause a symbol to appear longer than intended. 

Severity Code : 8 



IF0188 xxxxxxxx IS AN UNDEFINED SYMBOL 

Explanation : The symbol that appears in the message text has 
net appeared in the name field cf another statement, cr as an 
operand cf an EXTRN or WXTRN statement. 

Assembler Action : Reference to the undefined symbol results in 
a zero value. 

Prog rammer R e sponse : Define the symbol in the program. 

Severity Cede : 8 



IF0189 INVALID ENTRY OPERAND, LINKAGE CANNOT EE PERFORMED 

Expl anation: The symbol in the operand field of an ENTRY 
statement is invalid because it is either undefined or 
improperly defined. 

Assembler Ac t ion : The invalid symbol in the operand field is 
processed as a comment, and no linkage is provided if another 
program references it. 

Programmer Response : Eefine the symbol at an appropriate place 
in this program, or correct it. A valid symbol consists cf from 
1 to 8 alphameric characters, the first of which is blank- 
Severity Code: 8 



IFO190 OPERAND OF PUSH STATEMENT IS NOT USING OR PRINT NEAR OPERAND 
COLUMN nn 

Explanation : The only symbols allowed in the operand field of a 
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PUSH cr POP statement are PRINT and USING, in any order, 
separated by commas. 

Assembler .Action ; The PUSH instruction is prccessed as a 
conment. 

Programmer Response: Be sure the operand of the PUSH statement 
is either PRINT or USING or both. 



Severity Code : 4 



IF0191 PUSH LEVEIS EXCEED 4 NEAR OPERAND ' COLUMN nn 

Explanation : More than 4 levels of PUSH and PCP statements were 
attempted fcr either PRINT or USING. 

Asse mbler Ac tion: The PUSH instruction is processed as a 
comment. 

Programmer Response : Rework the program lcgic tc require no 
mere than 4 levels of PUSH and POP fcr USING and 4 fcr PRIKT-- 

Severity Cede : 8 



IFC192 OPERAND OF POP STATEMENT IS NOT USING OR PRINI NEAR OPERAND 
COLUMN nn 



Explanation : The only symbols allowed in the cperand cf a PUSH 
cr PCP statement are USING and PRINT, in any crder, separated 
by commas. 

Assembler Action : The POP instruction is processed as a comment. 

Programmer Response : Ee sure the cperand cf the POP statement 
is either PRINT cr USING or both. 



Severity Ced e : 4 



IF0193 FOP REQUEST NOT EALANCEE EY PREVIOUS PUSH 

Explanation : No PUSH request was issued prior tc this PCP 
request, cr mere POP statements have been issued than PUSH 
statements. A PCP statement restores the USING or PRINT status 
saved by the most recent PUSH statement, en a cne fcr cne basis. 

Asse m bler Actic n: The POP instruction is processed as a comment. 

Programmer Response : Check for errors in balancing PUSH and POP 
statements , or rework the program logic to request balanced PUSH 
and FOP statements. Repetition of a given cperand (i.e., USING 
or PRINT) on a single PUSH or POP statement is treated as 
multiple statements, and could cause unbalanced PUSH and POP 
statements. 

Severity Cede : 8 
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IF019U INVALID OPTION IN PRINT STATEMENT NEAR OPERANE COLUMN nn 

.Explanation : £n option appears in the operand field of a PRINT 
stateirent that is not one of the following: ON, OFF, GEN, 
NOGEN, DATA, and NCDATA. 

Asse mbler Action : The invalid operand is ignored. 

Prog ramme r Response : Be sure that only the options listed in 
the explanation above appear in the operand field of a PRINT 
statement. 



IF0195 INVALID USING OR DROP STATEMENT NEAR OPERAND COLUMN nn 
Explanation : One of three errors has occurred: 

(1) register is specified for other than the second operand 
cf a USING stateirent, or 

(2) a register number outside the range of to 15 has been 
used , or 

(3) a DROP stateirent has been issued for a register that was 
never assigned for use ty a USING stateirent. 

Assembler Action : The invalid register specification is set to 
zero. 

Progr ammer Response : The second and following operands of a 
USING or DROP instruction must be decimal terms to 15. 
Register may only fce specified as the seccr.d operand of a 
USING stateirent. 

Severity Code : 12 



IF0196 xxxxxxxx HAS BEEN PREVIOUSLY DEFINED 

Explanation : The specified symbol has previously appeared in 
the name field of a stateirent or in the cperard field cf an 
EXTRN or fiXTRN instruction. 

assembler Action : All references to the symbol are interpreted 
as references to the first definition cf the symbol. 

Prog rammer Response : A given symbol must be defined only once. 
Determine which occurrence of the symbol you want to use, and 
change all others. 

Seve rity Cede : 8 



IF0197 *** MNOTE *** 

Expl a nation : An MNOTE statement has been encountered during the 

generation cf a macro or in open code. The text of the MNOTE 

message appears in-line in the listing at the pcint where it is 
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encountered. (Refer to CS/VE Assembler Language for a 
description of the MNCTE instruction.) 

Assembler Action : None. 

Prcgr airirer R e s po nse ; Investigate the reason for the MNOTE. 
Errors flagged by MNOTE will often cause unsuccessful execution 
of the program, depending upon the severity cede. 

Severit y Cede; An MNCTE is assigned a severity code of to 255 
by the writer of the MNCTE statement. 



IF0198 INVALID TYPE DECLARED ON DC/DS/DXD CONSTANT NEAR OPERAND CCL-UKK 
nn 

Explanation ; Operand subfield 2 is not a valid type for a DC, 
DS, or DXD statement. Valid types are the following: A, B, C, 
E, E, F, B, L, P, Q, S, V, X, Y, and Z. 

Asse mbler Action ; The statement that contains the invalid type 
declaration is processed as a comment. 

Programmer Response : Supply a valid type in operand subfield 2. 

Severity Code : 8 



IF0199 INVALID LENGTH MODIFIER NEAR OPERAND COLUMN nn 

Explanation; The length modifier in operand subfield 3 of this 
statement is invalid. The length attribute of a symbol is not 
allowed as a term in the length modifier expression fcr the 
first operand cf the DC, DS, or EXD statement in which the 
symbol is defined. For example, SYM DC CL (L f SYK) *AA' is 
invalid. 

Assenbler Action ; The statement that contains the invalid 
length modifier is processed as a comment. 

Progr ammer Response : Supply a valid length modifier, or 
eliminate the explicit length modifier. 

Severity Code ; 8 



IFO200 INVALID SCALE MODIFIER NEAR OPERAND COLUMN nn 

Explanat i on ; The scale modifier in operand subfield 3 of a DC, 
DS, or DXD statement is invalid. The scale modifier should be 
either a decimal value or an absolute expression enclosed in 
parentheses. 

Assembler Action ; The statement that contains the invalid scale 
modifier is processed as a comment. 

Progr ammer Response ; Supply a valid scale modifier for the type 
of constant used. 

Severity Code ; 8 
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IFO201 ILLEGAL OR INVALID EXPONENT MODIFIER IN DC/DS/DXD CONSTANT NEAP 
OPERAND COLUMN nn 

Expl anation; An exponent modifier used in a DC, DS, cr DXD 
constant is not a decimal self-defining term, an absolute 
expression enclosed in parentheses, cr produces a value cutside 
the range allowed for that constant type. 

Ass e m bler Action ; The invalid or illegal operand is ignored. 

Programmer Response ; Be sure that the exponent modifier used 
conforms tc the rules for exponent modifiers fcr each type of 
DC, DS, cr DXD constant. 

Seve rity Cod e; 8 



IFO202 ARITHMETIC PRECISION OF FLOATING-POINT CONSTANT LOST NEAR 
OPERAND COLUMN nn 

Explanation ; Low order digits were lest durirg the construction 
cf an L- , E- , cr E-type constant, because the designated field 
was tco small to contain the whole constant. 

Assembler Action ; The value of the constant is set tc zero. 

Pro grammer Response ; Check the length, scale, and exponent 
modifier of the flagged constant. 

Severity Code ; 8 



IFO203 L-, D-, E-, F- , H- , OR Y-TYPE CONSTANT TRUNCATED, HIGE CPDER 
DIGITS LOST NEAR OPERANE COIUKK nn 

Explanation ; The high order digits cf an L-, D-, E-, F-, H-, or 
Y-type constant were lost because the designated field was toe 
small tc contain the whole constant. 

Assembler Action ; Processing continues using the truncated 
constant. 

Programm er Response ; modify the explicit or implicit length of 
the constant , so that the value may be contained within the 
area designated for it. 

Severity Cede ; 4 



\ / 
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IFO204 RELOCATABLE EXPRESSION NOT ALLOWED IN A- OR Y-TYPE ADDRESS 
CONSTANT WITE EIT LENGTE SPECIFICATION 

Explanation: A relocatable expression in used to specify a 
constant for which bit length specification is used. This is 
not allowed. 

Assembler Ac tion : The value of the operand is set to and no 
entry for this constant is made in the relocation dictionary. 

Programmer Response : Convert the operand to an absolute 
expression, cr use a length of 3 cr 4 bytes fcr A-type or 2 
bytes fcr Y-type constants. 

Severity Code : 8 



IFO205 RELOCATABLE Y-TYPE CONSTANT, VALUE TRUNCATED TO RIGHTMOST 2 
EYT ES 

Explanation: A relocatable Y-type constant has been declared. 
This is a warning only. All relocatable Y-type constants are 
diagnosed in this manner because the assembler must provide an 
entry in the relocation dictionary for each one. If the actual 
address is contained within the rightmost twc bytes and the 
coding is otherwise correct, when the program is loaded and 
relocation is considered the constant will be resolved. If the 
address cannot be contained in the rightmost two bytes, it is 
likely that further relocatability errcrs will result. 

Assemble r Action : The value of the constant is truncated to the 
rightmost twc bytes. 

Programmer Response : Ee sure that the value cf the Y-type 
constant will not exceed two bytes when the program has been 
leaded and the relocation factor has been considered. 

Severity Code : 4 



IF0206 DUPLICATION FACTOR ERROR 

Explanation: The duplication factor in a DC, DS, cr DXD 
statement is negative. 

Asse mble r Action : No storage is reserved fcr the operand, but 
alignment is performed as required by the type of constant used. 

Programmer Response : Supply a non-negative duplication factor. 

Severity Code: 8 



IFO207 OPERAND OF Q-TYPE CONSTANT DOES NOT NAME A ESECT OR EXE 

Explanation : The symhol in the operand field cf a Q-type 
constant must have been previously defined as the name cf a 
DSECT cr DXD section. 

Assembler Action : The value of the constant is set tc 0. 

Programmer Response : Define the symbol as the name cf a DSECT 
cr EXE section. The symtol must te defined befcre being used 
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in the constant. 
Severity Cede : 8 
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IFO208 DISPLACEMENT GREATER THAN X'FFF* 

Explanation; The displacement of this statement or the address 
referenced by this statement is greater than X'FFF 1 (decimal 
4095) . The displacement field in the machine instruction must 
contain a value cf from to 4095. 

Assembler .fiction ; The base and displacement fields cf the 
machine instruction are set to 0. 

Programmer Response : Correct the displacement term or 
expression or provide another base register with a USING 
statement. 



Severity 



8 



IFO209 AEERESSAEILITY ERROR - EASE ANE DISPLACEMENT CANNOT BE RESOLVED 
AND ARE SET TO 

Explanation ; The assembler cannot resolve the address of this 
statement or the address referenced by this statement for one 
cf the following reasons: 

• Current USING registers produce a displacement of less than 
or greater than 4095. 

• No USING registers are available. 

assembler Action : The base and displacement fields cf the 
machine instruction are set to . 

Programmer Response : Make sure you have ccrrectly set up base 
registers with the USING instruction. Be sure the referenced 
address can be specified by the value in a USING register plus 
a displacement in the range of through 4095. 

Severity Cede : 8 



IFO210 TOO FEW OPERANTS 

E xplanation ; Mere operands are required for this statement, hut 
they were not found. 

Assembler Action ; The value of any irissing operand is set to 0. 

Programmer Response ; Supply the necessary cperands. Refer to 
Principles cf Operation for details en the cperands required 
fcr this instruction. 

Severity Cede : 1 2 
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IF0211 TOO MANY OPERANDS 

Explanation: 

© Mere than 255 operands in a DC, DS, or DXE instruction; or 

loo many operands in a machine instruction. 

Assembler .Action ; The extra operands are ignored. 

Programmer Response : Delete the extra operands. Refer to 
Principles cf Operation for details on operands required for 
individual irachine instructions. 

Severity Cede: 12 



IFC212 PREMATURE END OF OPERAND NEAR OPERAND COLUMN nn 

Exp lanation: A term or an expression used as an operand is 
incomplete. 

Assembler Action : The value of the operand is set tc 0. 

Programmer Response : Supply the characters necessary tc 
terminate the operand. 

Severity Cede: 8 



IF0213 COMPLEXLY RELOCATAELE EXPRESSION NEAR OPERAND COLUMN nn 

Expl ana ti on : The indicated operand contains a complexly 
relocatable expression. The expression should be absolute or 
simply relocatable. 

Assembler Act icn : The value of the complexly relocatable 
expression is set to 0. 

Programmer Response : Ee sure that only absolute and simply 
relocatable expressions are used in the operand field cf this 
statement. 

Severity Code : 8 



IF0214 ILLEGAL USE OF LITERAL NEAR OPERAND COLUMN nn 

Explanat ion : A literal is used in an assembler instruction, in 
another literal, or in a field of a machine instruction where 
it is not allowed. 

Assembler Acticn : The value of the operand where the literal is 
used is set tc 0. 

Prcg rammer Response : Use a valid relocatable term or expression 
in place of the literal. If applicable, replace the literal 
with the name of a DC statement which defines the same constant 
as the literal. 

Severity Code : 12 
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IF0215 ILLEGAL DELIMITER, RIGHT PARENTHESIS EXPECTED NEAR OPERAND 
COLUMN nil 

Expla nation : A right parenthesis was expected as a delimiter, 
but none was found. 

Assembler Action : The value of the operand that is lacking a 
right parenthesis is set to 0. 

Programmer Response : Supply a right parenthesis. 

Severity Cede : 8 



IFC216 ILLEGAL OPERAND EORMAT NEAR OPERAND COLUMN nn 

Explanation : The operand of this statement is illegally 
constructed. 

Assem bler Ac ticn : The value of the operand is set to 0. 

Progr ammer Response : Refer to Principles of Operation for 
details on the operand structure of this statement, and supply 
a valid operand. 

Severity Cede: 12 



IFC217 RELCCATAEILITY ERROR NEAR OPERAND COLUMN nn 

Explanation : One of the following fields contains a relocatable 
value. All values in these fields must be absolute. 

• Immediate field in an SI instruction 

• Mask field 

• Register specification 

• Length modifier 

Assembler Acticn: If any of the above fields contains a 
relocatable value, the value of the field is set to 0. 

Programm er Response : Be sure that the field contains an 
absolute value. 

Severity Code : 12 



IF0218 INVALID REGISTER SPECIFICATION - EVEN-NUMEEREE REGISTER REQUIRED 

Expl a nation : An odd-numbered register was specified in a 
context that requires an even-numbered register. 

Assembler Action : The invalid operand is set tc 0. 

Programmer Response : Specify an available even-numbered 
register. Refer tc the Principle s cf Operation for details on 
the register requirements of this instruction. 
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Severity Code : 12 

IF0219 REGISTER OR IMMEDIATE FIEID OVERFLOW NEAR OPERAND CCIUMK nn 

E xpl anation : 

• The value cf the immediate field used in an SI instruction 
is greater than 255; or 

o A register number was specified that was greater than 15. 

Assem ble r Ac tion: The value of the field where the overflow 
occurred is set to 0. 

Programmer Response : Ee sure the value cf an immediate field 
dees net exceed 255 and that no register number greater than 15 
is specified. 

Severity Code : 8 

IFO220 ALIGNMENT ERROR NEAR OPERAND COLUMN nn 

Explanation: The operand of this instruction refers to a main 
storage location that is not on the boundary required by the 
instruction. 

Assemb ler Ac t ion : The faulty alignment is unchanged. 

Prcgrammer Re sponse : Align the main storage location referenced 
in the operand field. Refer to the Principles of Operation for 
details on the boundary requirements cf this instruction. For 
machines that do not require data to be aligred to certain 
boundaries, specify NCALIGR as an assembly option and no error 
will occur. 

Severity Cede: 4 



IF0221 ILLEGAL INDEX REGISTER CR LENGTH MODIFIER NEAR OPERAND CCIDKK nn 

Explanation: An index register or a length field was specified 
for a machine instruction where none is expected. 

Assembler Action : The invalid specif icaticn is igncred. 

Programmer Response : Correct the index register cr length field 
specif icaticn. 

Severity Cede: 12 



IF0222 INVALID INEEX REGISTER SPECIFIED NEAR OPERAND COLUMN nn 

Explanaticn : A register number net in the range 0-15 has been 
specified as an index register. 
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Ass e m bler Action : A default value of (to indicate that no 
indexing is used) replaces the invalid index register 
specification in the machine instructicn. 

Programme r Response ; Specify an available register in the range 
cf tc 15 as an index register. 

Severity Cede : 1 2 



IF0223 RELOCATABLE INDEX REGISTER SFECIFIED NEAR OPERAND COLUMN nn 

Explanation : A relocatable value has been specified as an index 
register. 

Assembler Action: A default value of (to indicate that no 
indexing is used) replaces the invalid index register 
specification in the machine instructicn. 

Programmer Response : Specify an absolute value in the range of 
tc 15 as an index register. 

Severity Cede : 1 2 



IF 02 2 4 LENGTH ERROR NEAR OPERAND COLUMN nn 

Expla nation : 

9 The length modifier of a constant is illegal or invalid for 
the type of constant; or 

• A constant of type C r X, E, Z r or P is too long; or 

e A relocatable address constant has an illegal length. 

Assembler Action : The operand in error and any following 
operands cf the EC, ES r or DXD statement are processed as 
comments. An address constant with an illegal length is 
truncated. 

P rogrammer R e sponse : Supply a valid length modifier or decrease 
the length cf the operand. 

Severity Code : 8 



IF0225 RELOCATABLE LENGTH FIELD IN MACHINE INSTRUCTION NEAR CFERAKD 
COLUMN nn 

Explanation: The length field of this machine instruction is 
specified as relocatable; an absolute term or expression is 
required. 

Assembler Action : The length field in errcr is assembled tc 

Programmer Response : Use an absolute term cr expression tc 
specify the length field. 

Seve rity Cede : 4 
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IFC226 EASE REGISTER OF MACHINE INSTRUCTION NOT RESOLUTE NEAR OPERAND 
COLUMN nn 

Explanation: An explicit base register has been specified as a 
relocatable value; an absolute term or -expression is required. 

Asse mbler Action; The operand in error (base and displacement) 
is assembled to 0. 

Programmer Response : Use an absolute term cr expression to 
specify the tase register. 

Severity Code: 12 



IF0228 RELOCATABLE DISPLACEMENT IN MACHINE INSTRUCTION NEAR OPERAND 
COLUMN nn 

Explanation: In a machine instruction that has an explicit base 
register specification, the specification for the displacement 
field is relocatable. As this wculd imply a second base 
register, the combination is invalid. 

Assem ble r Act ion: The displacement field of the machine 
instruction is assembled to . 

Programmer Response : Either specify the displacement as an 
absolute term cr expression, or delete the explicit base 
register. 

Severity Code: 8 



IF0229 POSSIBLE REENTERABILITY ERROR NEAR OPERAND COLUMN nn 

Expla nat icn: This machine instruction could store data into a 
control section or common area that is not dynamically acquired. 
This message is produced only when the RENT assembler cption is 
specified in the PARtf field of the EXEC statement. 

Assembler Action : The statement is assembled as written. 

Programme r Response : If you want reentrant cede, correct the 
instruction so that it references a DSECT or other dynamically 
acquired space. Otherwise you can suppress reentrant checking 
by specifying the NORENT assembler option. 

Note : Absence of this message dees net guarartee reentrant 
code, as the assembler has no control ever addresses actually 
loaded into base and index registers at program execution time. 

Severity Code : 4 



IFO230 BASE REGISTER NUNBER GREATER THAN 15 NEAR OPERAND CCLDKK nn 

Explanation: An explicit base register in a machine instruction 
or S-type address constant is greater than 15. 

Assembler Action : The base register field of the machine 
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instruction is assembled to 0. 

Programm er Response : Specify the base register in the range of 
to 15. 

Severity Code : 12 



IF0231 SYMBOL NOT PREVIOUSLY DEFINED - XXXXXXXX 

Exp la nation : A symbol in this statement is used in a way that 
requires previous definition, but it has net been previously 
defined. For example, a symbol in a duplication factor 
expression or modifier expression of a DC statement must be 
previously defined. 

Assembler Action : The value of the symbol or the expression 
that contains it is set to 0. 

Prog rammer Response : Define the symbol earlier in the program. 

Add a defining statement if it does not exist, or place the 

existing defining statement ahead of the statement that 
references it. 



Severity Code : 8 



IF0233 MORE THAN 6 LEVELS OF PARENTHESES NEAR OPERAND COLUMN NN 

Expl a nation : An expression in this statement contains more than 
six nested levels of parentheses. 

Assembler Action : The value of the expression is set to 0. 

Programmer Response : Rewrite the expression tc reduce the 
number of levels of parentheses, or use a preliirinary statement 
(such as an EQU) tc partially evaluate the expression. 

Seve rit y Code : 8 



IF0234 PREMATURE ENE OF EXPRESSION NEAR OPERAND COLUMN nn 

Explanation : An expression in this stateirent ended prematurely 
due to one of the following errors: 

9 Unpaired parenthesis 

• Illegal character 

• Illegal operator 

• Operator not followed ty a term 

Asse mble r Ac t ion : The value of the expression is set to 0. 

Prc grammer Re sponse : Check the expression for omitted or 
mispunched characters or terms. 

Severity Code : 8 
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IF0235 ARITHMETIC OVERFLOW NEAR CFERAND COLUMN nn 

Explanation ; The intermediate value of a terir cr an expression 
is net in the range -231 through 231-1. 

Ass embler Action : The value of the expression is set to 0. 

P rog rammer Re sponse : Rewrite the expression or term. The 
assembler computes all values using fixed-point full-word 
arithmetic. Or, perform arithmetic operations in a different 
sequence tc avoid overflow. 

Severity Cede : 8 



IF0236 ILLEGAL CHARACTER IN EXFRESSICN NEAR OPERAND COLDWN nn 

Expl anation: Syntax error. A character in an expression has no 
syntactic meaning in the context used; the assembler cannot 
determine if it is a symtol, an operator, cr a delimiter. 

Assem ble r Action : The value of the expression is set to 0. 

Programme r Response : Check the expression for unpaired 
parentheses , ' invalid delimiter, invalid operator, or a character 
(possibly unprintable) that is net recognized by the assembler. 
The 51 characters recognized ty the assembler are: 

Letters: A through Z and $ # a 

Eigits: through 9 

Special Characters: +-,=.* ( ) * / £ 

Elank 

Seve rity Cede: 8 



IF0237 CIPCULAR DEFINITION 

Explanation: The value of the first expression in the operand 
field of an EQU statement is dependent upon the value of the 
symbol being defined in the name field. 

Ass embler Ac t ion : The value of the expression defaults to the 
current location counter value. 

Programmer Response : Remove circularity in the definition. 

Severity Code : 8 



IF0238 ILLEGAL AMPERSAND IN SELF -DEFINING TERM NEAR OPERAND CCLIWK nn 

Explanation: An ampersand in a self-defining term is unpaired 
and/or not part of a quoted character string. 

Assembler Action : The value of the expression containing the 
self-defining term is set to 0. 

Progr ammer Response : Check that all ampersands in the term are 
paired N and part of a quoted character string. (The only valid 
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use cf a single ampersand is as the first character of a 
variable symbol.) Note that ampersands produced by substitution 
must also be paired. 

Severity Code : 8 



IF0239 INVALID FLOATING POINT CHARACTERISTIC 

Expl anation: A converted floating-point constant is too large 
or too small for the field assigned to it. The allowable range 
is 7.2x1075 to 5.3x10-77. 

Asseirbler Action : The floating-point constant is assembled to 0. 

Programmer Response : Check the characteristic (exponent) , 
exponent modifier, scale modifier, and mantissa (fraction) for 
validity. Remember that a floating-point constant is rounded, 
not truncated, after conversion. 

Seve rity Cede : 8 



IFC2U0 CHARACTER STRING OR SELFDEFTNING TERM TERMINATED BEFORE ENDING 
QUOTE FOUND 

Explanation : The assembler has found what appears to be a 
gucted character string or a self-defining term, but the 
closing quote is missing, or an illegal character is found 
before the closing quote. 

Asseirbler Action : The term or expression is ignored. 

Programmer Response : Supply the missing quote or check for 
ether syntax errors. 

8 



IF02U1 SECOND OPERAND OF CCW NOT BETWEEN and X'FFFFFF* 

Explanation : The second operand cf a CCVi instruction, which 
specifies the data address, is outside the range cf to 
X ■ FFFFFF ' . 

Assembler Action : The low-order three bytes cf the operand are 
used. 

Pro grammer Response : Supply a correct term or expression for 
the second operand. 

Severity Code : 8 



IF02U2 SPACE OPERAND NOT A SINGLE POSITIVE DECIMAL SFLFEEFTKING TERM 

Explanation : The operand of a SPACE instruction is not a zero 
or positive decimal self -defining term. 
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Assembler Action : The SPACE statement is processed as a comment, 

Programmer Re sponse : Use a single decimal self-defining term 
with a zero or positive value. 

Severity Code : 4, 



IF0243 FIRST CCW OPERAND IS NEGATIVE 

Explanation: The first operand (command cede) cf a CCW 
instruction is negative. The value of the operand must te in 
the range 0-255. 

Assembler Action : The CCW is processed as a comment. 

Programmer R esponse : Supply an operand with a value in the 
range of 0-255. 

Severity Code: 8 



IF0244 BITS 38 AND 39 OF CCW OPERAND NCT ZERO 

Explanation : The bits specified as bits 38 and 39 of a CCW 
instruction are not zero. 

Assembler Action : The tits are set as specified. 

Programmer Response : Correct the third operard cf the CCW 
instruction. 

Severity Ced e: 8 



IF0246 LOCATION COUNTER OVERFLOW 

Explanation : The location counter is greater than X^FFEEF 1 
(224-1) , the largest address that can be contained in 3 bytes. 

Assembler Action : The location counter is 4 bytes long (only 3 
bytes appear in the listing and the object deck) . The overflow 
is carried into the high-order byte and the assembly continues. 
However, the resulting code will probably not execute correctly. 

Programmer Response : The probable cause of the error is a high 
ORG statement value or a high START statement value. Correct 
the value or split up the control section. 

Severity Cede : 8 
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IF0254 ILLEGAL FORMAT OF SECOND OPERAND OF END STATEMENT 

Explanation : Second operand of END instruction is inconsistent 
with the format required. 

As sembler Action : Second operand ignored. 

Progr ammer Response : Correct the operand. 

Se verity Cede : 8 



IF0255 FIXED OR FLOATING POINT EXPRESSION ERROR NEAR OPERAND CCLDKK nn 

Explanation : An error occurred during conversion of a decimal 
number into a, fixed-point or floating-point number. 

Assembler Action : The number is assembled as zeros. 

Programmer Response : Check the scale and exponent modifier of 
the number for validity. 

Severi ty Cede : 4 



IF0256 SYSGO ED CARD MISSING — NOOBJECT OPTION USEE 

Explanati on: A DD statement for the SYSGO data set is not 
included in the JCL for this assembly. The SYSGO data set 
normally receives the object module output of the assembler 
when it is to be used as input to the linkage editor or loader, 
executed in the same job. 

Assem bler Action : The program is assembled using the KCCEJECT 
option. No output is written on SYSGO. If the DECK option is 
specified, the object module will be written en the device 
specified in the SYSPUNCH DD statement. 

Programmer Response : Optional. If the assembly is errcr free 
and the object module has been produced en SYSPUNCH, ycu can 
execute it without; reassembling. Otherwise, reassemble the 
program and include a SYSGO DD statement in the JCL cr use a 
cataloged procedure that includes it. (See the section "The 
Assembler Cataloged Procedures" in this iranual.) 



Severity Cede: 



16 



IF0257 SYSPUNCH DD CARD MISSING — NODECK OPTION USEE 

Explanation: A DD statement for the SYSPUNCH data set is not 
included in the JCL for this assembly. The SYSPUNCH data set 
is normally used when the object module cf the assembly is 
directed to the card punch. 

Assembler Action : The program is assembled using the NODECK 
option. Nc deck is punched on SYSPUNCH. If the OBJECT option 
has been specified, the object module will be written on the 
device specified in the SYSGO DD statement. 

Progra mmer Response : Optional. The object module can be link 
edited and executed from SYSGO instead cf SYSPUNCH by adjusting 
JCL. Otherwise, if you want a punch data set, reassemble the 
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program with a SYSPUNCH EE statement. 
Severity Cede; 16 

IFC258 INVALID ASSEMELER OPTION ON EXEC CARD — OPTION IGNORED 

Explanation; One or more of the assembler options specified in 
the^PARM field of the EXEC statement are invalid. The error 
may be caused by use of the wrong option, a misspelled option, 
or syntax errors in coding the options. 

A sse m bler Action ; Invalid options are ignored. She assembly is 
performed using the valid options. 

Progr amm e r Response ; Check the spelling cf the options, the 
length of the option list (100 characters maximum) , and the 
syntax of the option list. The options must be separated by 
commas, and parentheses in the option list (including SYSPARM) 
must be paired. Two quotes or ampersands are needed to 
represent a single quote or ampersand in a SYSPARM character 
string. The section "Assembler Options" in this manual 
describes the assembler options and how to code them. 

Severity Code ; 16 

IFO260 ASSEMBLY TERMINATED — DD CARD MISSING FOR SYSxxx 

Explanation ; This assembler jet step cannct be executed because 
a EE statement is missing for one of the following assembler 
data sets; SYSUT1 , SYSUT2 , SYSUT3 , or SYSIN. The missing ED 
statement is indicated in the message text. 

Assemble r Action ; The assembly is terminated before any 
statements are assembled. No assembler listing is produced, so 
this message is printed on the system output unit following the 
job control language statements fcr the assembly jcb step and 
on the operator's console. 

Programmer Response ; Supply the missing DD statement and 
reassemble the program. The cataloged procedures supplied by 
IBM contain all the required DD statements. They are described 
in the section "The Assembler Cataloged Procedures" in this 
manual. 

If the problem recurs, do the following before calling IEM: 

o Have your source program, macro definitions, and associated 
listings available. 

o If a COPY statement was used, execute the IEBPTFCH utility 
to obtain a copy of the partitioned data set member 
specified in the COPY statement. 

o Make sure that MSGIEVEI= (1, 1) was specified in the JCB 
statement. 

Cperatcr Respcnse ; If possible, supply the missing DD statement 

in the JCL statements for the assembly and run the job again. 

Severity Code: 2 
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IF0261 ASSEMELY TEFMINATEE — PERM I/O ERROR jcbname, stepname, unit 
address, device type, ddnarae, operation attempted, error 
description 

Explanation; A permanent I/O error occurred on the assembler 
data set indicated in the message text. This message, produced 
by a SYNAEAF macro instruction, also contains mere detailed 
information about the cause of the error and where it occurred. 

.Assembler Action ; The assembly is terminated. Depending on 
where the error occurred, the assembly listirg up tc the point 
of the I/O error may be produced. If the listing is produced, 
this message appears on it. If the listirg is net produced, 
this message appears on the operators console and on the 
system output unit following the job ccntrcl language 
statements for the assembler job step. 

P rog r ammer Response ; If the I/C errcr is en SYS IN cr SYSLIE, 
you may have concatenated the input or library data sets 
incorrectly. Make sure the DE statement for the data set with 
the largest blccksize (BLKSIZE) is placed in the JCL before the 
EE statements of the data sets concatenated tc it. Also, make 
sure that all input or library data sets have the same device 
class (all DASD cr all tape) . 

In any case, reassemble the program; it may assemble correctly. 
If the problem recurs, do the following before calling IEM: 

• Have your source program, macro definitions, and associated 
listings available. 

• If a COPY statement was used, execute the IEBP1PCH utility 
to obtain a copy of the partitioned data set member 
specified in the COPY statement. 

• Make sure that MSGIEVEI= (1, 1) was specified in the JCB 
statement. 

Cperatcr Response ; If the I/O errcr is en SYSCH, SYS13I2, or 
SYSUT3 , allocate the data set to a different volume and rerun 
the job. If the I/O error is on tape, check the tape for 
errors . 

Seve rity Cede ; 20 



IF0262 2SSEMELY TERMINATED — INSUFFICIENT MAIN STORAGE 

Explanation ; The main storage allocated tc the assembler is not 
enough fcr assembler tables, working storage, and/cr utility 
file buffers. 

Assembler Action ; The assembly is terminated. 

Programmer Response ; Increase the size of the region cr 
partition allocated to the assembler. Reassenble the program. 
If the problem recurs, do the following before calling IEM: 

• Have your source program, macro definitions, and associated 
listings available. 

• Make sure that MSGLEVEL= (1, 1) was specified in the JCB 
statement. 
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Oper ator Res p onse ; 

• Increase the size of the region allocated on the JOE card 
or on the EXEC card for the assembler jcb step and rerun 
the jcb; cr 

• Run the job in a larger partition. 
Severity Code : 20 



IF0263 ASSEMBLY TERMINATED — PROGRAM LOGIC ERROR 

Explanat ion: The assembly has been abnormally terminated 
because of a logic error within the assembler. 

.Assembler fiction : Abnormal termination. Nc assembler listing 
is produced; the assembler prints this message en the system 
output device following the JCI statements for the assembler 
job step. 

Programmer Response : Do the following before calling IBM: 

• Have ycur source program, macro definitions, and associated 
listings available. 

• If a COPY statement was used, execute the IEBFTPCH utility 
program to obtain a copy of the partitioned data set member 
specified in the operand field cf the COPY statement. 

• Make sure that MSGLEVEL= (1, 1) was specified on the JCB 
statement. 

Severity Cede : 20 



IF0264 TOO MANY ESD ENTRIES 

Explanation : More than 399 entries have been irade in the 
external symbol dictionary. Entries in the external symbol 
dictionary are made for the following: control sections, dummy 
sections, external references (EXTRN and WXIRN) , ENTR^ symbols, 
and external dummy sections. 

Assembler fiction : Entries over the 399 limit are net added to 
the dictionary and linkage is net provided fcr them. 

Programme r Response : Subdivide your program and reassemble each 
section individually. Be sure that there are not more than 399 
ESE entries in each assembly. 

Sev erity Cede : 1 6 
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IF0265 SYWEOL RESOLUTION EATA AREA HAS BEEN EXHAUSTED 
Explanation ; 

• Too many literals have teen encountered since a LTCRG 
statement was encountered, and the assembler has filled 
available work space with literals; cr 

• The assembler has filled available wcrk space with ESE 
entries. 

Ass embler Action: No assembly is performed. 

Programmer Response : 

• Insert more LTORG statements in the scurce deck cr allocate 
mere working storage to the assembler; or 

• If there are more than 399 ESD entries in ycur source 
module, segment it into several modules. 

Seve rity Cede : 1 6 



IFC266 LAST ASSEMELER PEASE LOAEED WAS xxxxxxxx 

Explanation : This message is issued by the abort routine when 
the assembly is abnormally terminated. 

Asse n bler Action : Abnormal termination. 

Progr ammer Response : Correct problems indicated by other error 

messages and reassemble. _ 

Severity Code : 4 v / 



IF0267 SYSPRINT DD CARD MISSING — NCLIST OPTION USEE 

Expl anation: The LIST option is specified, but the EE statement 
for the SYSPRINT data set is not included in the JCL for this 
assembly. The SYSPRINT data set holds the cbject module output 
of the assembly normally directed to the printer. 

Assembler Action : The program is assembled using the NOLIST 
option. The message is printed en the systen output device 
following the JCL statements for the assembler job step and on 
the operator's console. 

Prcgrairmer Re sponse : If you want a listing, reassemble the 
program with a SYSPRINT DD statement. Otherwise, do not 
specify the LIST option. 

Operator Response : Supply, if possible, a SYSPRINT DD card for 
the assembler job step and rerun the jcb. 

Severity Cede: 16 
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IFC268 SYSTERM EE CARE MISSING - NOTERMINAL OPTION USEE 

Explanation : The TERMINAL option is specified, but the EE 
statement for the SYSTERM data set is net included in the JCL 
statements fcr this assembly. The SYSTERM data set contains 
diagnostic information output of the assembly, normally 
directed tc a remote terminal. 

Pro grammer Response : If you want a SYSTERM listing, reassemble 
the program with a SYSTERM DE statement. Otherwise, do not 
specify the TERMINAL option. 

Operator Response: Supply, if possible, a SYSTERM EE card for 
the assembly step and rerun the job. 

Severity Code: 16 



IF0269 SYSLIB EE CARE MISSING 

Explanation : 

m A COPY instruction appears in the assembly, but nc S¥SLIE 
EE statement is included in the JCL statements; cr 

9 An operation code that is net a machine, assembler, cr 
source macro instruction operation cede appears in the 
assembly, but no SYSLIB EE statement is included in the JCL 
statements. The assembler assumed the cperaticn cede tc be 
a library macro operation code. 

Assembler Action : 

© The COPY instruction is ignored; cr 

© The operation code is treated as an undefined operation 
cede. 

Prog rammer Response : Supply the missing EE statement or correct 
the invalid operation code. 

Severity Code : 16 
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NOESD option 18 
NOLIBMAC option 19 
NOLIST option 18 
NOMCALL option 18 
NOMLOGIC option 18 
NONUMBER option 21 
NOOBJECT option 20 
NORENT option 22 
NORLD option 19 
NOSTMT option 21,75 
NOTERMINAL option 21,75 
NOTEST option 20 
NOXREF option 19 
NUM option 21 
NUMBER option 21,75 



OBJ option 20 

object code in listing 40 

object deck output 65-69 

END 67 

ESD 65 

RLD 66-67 

SYM 67-69 

TXT 66 
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object module 
definition 7 
records of 65-69 
object module linkage 
OBJECT option 20 

options, assembler (see assembler options) 
options in listing 46 
output control options 20 
output from assembler 7 
overriding parts of cataloged 
procedures 32-33 



page size, assembler listing (see LINECOUNT 

option) 
PARM field 

(see also assembler options) 
acquiring information in 49 
coding rules 16-17 
overriding in cataloged 
procedures 16,32 
performance, influencing (see assembler 

speed and capacity) 
PL/I (see problem-oriented languages) 
PRINT instruction 38,40 
problem-oriented languages, linking 

with 48 
procedures, cataloged (see cataloged 

procedures) 
program design 47 
program listing (see assembler listing) 



74 



RECFM for assembler data sets 
recurring errors 80 
reentrability check 22 
relocatable constants 41 
relocation dictionary 41 
RENT option 22 
return code 80 

RLD (see relocation dictionary) 
RLD card 66-67 
RLD option 19 



Sample program 57-64 
Save area 47 
Saving registers 47 
Severity code 80,46 



source and machine language statements in 

listing 38-40 
source module 7 

source statement in listing 38-40 
statement number 40,46,78 
statistics listing 45-46 
step 10 

storage requirements, virtual 73 
STMT option 21,75 
SYM card 6 7-6 9 

symbol cross reference listing 42-43 
SYS1.MACLIB 50,72 
SYSGO data set 73,74 
SYSIN data set 72,74 
SYSLIB data set 72,74 
SYSPRINT data set 71,72,74 
SYSPUNCH data set 73,74 
SYSTERM data set 73,74 
SYSTERM listing 75-77 
SYSTERM options 21 
SYSUT1, SYSUT2, SYSUT3 data sets 72,74 



TERM option 21 

TERMINAL option 21,75 

terminal output (see SYSTERM listing) 

TEST option 20 

Time Sharing Option 75 

TSO (see Time Sharing Option) 

TXT card 66 



use of assembler cataloged 

procedures 13-15,32-33 
utility data sets 72,74 

(see also BUFSIZE option) 



virtual storage requirements 73 



work space, assembler 22,73 



XCTL macro 70 
XREF option 19 
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